home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu084.dms / pu084.adf / c-64emulator.doc < prev    next >
Text File  |  1991-05-01  |  143KB  |  4,423 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                The A64 Package
  27.  
  28.                         Copyright (C) 1990, QuesTronix
  29.  
  30.                      Designed and Written By: Cliff Dugan
  31.  
  32.  
  33.  
  34.                                   QuesTronix
  35.                                 P.O. Box 340285
  36.                             Hartford, CT 06134-0285
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                       8/90 1.00
  65.  
  66. -
  67.  
  68.  
  69.  
  70. COPYRIGHT
  71.  
  72.     The A64 Package, Copyright (C) 1990, QuesTronix.
  73.  
  74.     All programs in The A64 Package including, but not limited to: A64, 64Cmd,
  75.     64Dir, 64Print, 64Status, 64ToAmiga, AmigaTo64, Pet2ASCII and StripLoadAddr
  76.     are Copyright (C) 1990, QuesTronix.
  77.  
  78.     All documentation in The A64 Package including this manual are Copyright
  79.     (C) 1990, QuesTronix.
  80.  
  81.  
  82. LICENSE AGREEMENT    
  83.  
  84.     The A64 Package is being licensed to you.  You may use and distribute The
  85.     A64 Package as long as the following terms are agreed to:
  86.  
  87.     The A64 Package may not be modified in any way.  If distributed, it must
  88.     include all of the original programs and documentation it came with and all
  89.     copyright notices must remain intact.
  90.  
  91.     You may not reverse engineer any of the programs in The A64 Package nor may
  92.     you examine their inner workings in any way.
  93.  
  94.     The A64 Package may not be distributed for profit nor will it be made part
  95.     of a "for sale" public domain software collection without prior written
  96.     permission from QuesTronix.
  97.  
  98.     QuesTronix is charging a license fee, of $25.00 (plus $3.00 for shipping
  99.     and handling of the hardware interface), for the use of The A64 Package. 
  100.     After receiving the license fee, from you, QuesTronix will send you the
  101.     hardware interface that is used with most of the programs in The A64
  102.     Package. 
  103.  
  104.     Your use of any program in The A64 Package states that you agree to these
  105.     terms and have accepted this license agreement.
  106.  
  107.  
  108. DISCLAIMER
  109.  
  110.     The A64 Package is provided "as is" without warranty of any kind, either
  111.     expressed or implied, including, but not limited to, the implied warranties
  112.     of merchantability and fitness for a particular purpose.  In no event will
  113.     QuesTronix be liable for incidental, consequential or other similar
  114.     damages.  The entire risk as to the quality and performance of The A64
  115.     Package is with you.
  116.  
  117.     QuesTronix reserves the right to change The A64 Packages' Copyright status
  118.     and/or cost at any time, without notice.
  119.  
  120.  
  121. CREDITS
  122.  
  123.     The A64 Package was designed and written by Cliff Dugan.
  124.  
  125.  
  126.  
  127.  
  128.                                                                           1
  129.  
  130.  
  131.  
  132. -
  133.  
  134.  
  135.  
  136. SYSTEM REQUIREMENTS
  137.  
  138.     All programs in The A64 Package will work with V1.2 or higher WorkBench.
  139.  
  140.     The utility programs included with The A64 Package will run with 512k RAM.
  141.  
  142.     A64 will run "as is" with 1mb RAM, but can be made to run with 512k RAM
  143.     (See A64 AND MEMORY in the TECHNICAL section).
  144.  
  145.     All programs included with The A64 Package will work with the 68000
  146.     microprocessor only (See 680x0 SUPPORT in the TECHNICAL section).
  147.  
  148.     If the hardware interface is used, a separate adapter cable is required for
  149.     the Amiga 1000.
  150.  
  151.  
  152. UPDATES
  153.  
  154.     If enough people support The A64 Package, by sending in the license fee,
  155.     it will be updated from time to time.  QuesTronix will notify registered
  156.     owners, by mail, whenever The A64 Package has a major revision (See
  157.     WHAT IS IN THE FUTURE section).
  158.  
  159.  
  160. REPLACEMENTS
  161.  
  162.     QuesTronix will provide replacements of either the hardware interface or
  163.     The A64 Package should either become damaged.  Replacements will be made
  164.     available to registered owners only and will cost a nominal fee.  Please
  165.     contact QuesTronix for exact details on replacements.
  166.  
  167.  
  168. TECHNICAL SUPPORT
  169.  
  170.     QuesTronix will provide technical support to REGISTERED OWNERS ONLY!  To
  171.     become a registered owner you must fill out the registration form and mail
  172.     it with the license fee to QuesTronix (See HOW TO BECOME A REGISTERED OWNER
  173.     in the INTRODUCTION section).
  174.  
  175.  
  176. HOW TO CONTACT QUESTRONIX
  177.  
  178.     QuesTronix's phone number has deliberately been omitted from The A64
  179.     Package.  We do not have the resources to answer phone calls from
  180.     unregistered users.  Upon becoming a registered owner QuesTronix will make
  181.     its phone number available to you.  Until then you may contact QuesTronix
  182.     by writing to:
  183.  
  184.                                   QuesTronix
  185.                                 P.O. Box 340285
  186.                             Hartford, CT 06134-0285
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         2
  195.  
  196.  
  197.  
  198. -
  199.  
  200.  
  201.  
  202. TRADEMARKS
  203.  
  204.     The A64 Package, A64, A64 BASIC, A64 Prefs, A64Mon and QuesTronix are
  205.         trademarks of QuesTronix.
  206.  
  207.     Commodore 64 and C64 are trademarks and COMMODORE is a registered trademark 
  208.         of Commodore Electronics, Ltd.
  209.  
  210.     Amiga, AmigaDOS and Workbench are registered trademarks of
  211.         Commodore-Amiga, Inc.
  212.  
  213.     GO-64! is a trademark of Software Insight Systems, Inc.
  214.  
  215.     The 64 Emulator is a trademark of ReadySoft, Inc.
  216.  
  217.     Deluxe Paint is a trademark of Electronic Arts.
  218.  
  219.     PrintShop is a trademark of Broderbund Software.
  220.  
  221.     GEOS is a trademark of Berkely Softworks.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                                                           3
  261.  
  262.  
  263.  
  264. -
  265.  
  266.  
  267.  
  268. TABLE OF CONTENTS
  269.  
  270.     COPYRIGHT .........................................................    1
  271.     LICENSE AGREEMENT .................................................    1
  272.     DISCLAIMER ........................................................    1 
  273.     CREDITS ...........................................................    1
  274.     SYSTEM REQUIREMENTS ...............................................    2
  275.     UPDATES ...........................................................    2
  276.     REPLACEMENTS.......................................................    2
  277.     TECHNICAL SUPPORT .................................................    2
  278.     HOW TO CONTACT QUESTRONIX .........................................    2
  279.     TRADEMARKS ........................................................    3
  280.  
  281.     INTRODUCTION ......................................................  1-1
  282.         WHAT IS THE A64 PACKAGE? ......................................  1-1
  283.         WHAT IS NEEDED? ...............................................  1-1
  284.         WHAT DOES IT COST? ............................................  1-2
  285.         HOW TO BECOME A REGISTERED OWNER ..............................  1-2
  286.         A NOTE FROM THE AUTHOR ........................................  1-3
  287.  
  288.     GETTING STARTED ...................................................  2-1
  289.        RUNNING A64 ....................................................  2-1
  290.        A64'S HARDWARE INTERFACE .......................................  2-3
  291.        INSTALLING A64'S HARDWARE INTERFACE ............................  2-3
  292.        INSTALLING THE A64 PACKAGE ON ANOTHER DISK OR HARD DISK ........  2-4
  293.  
  294.     A64 PREFS .........................................................  3-1
  295.         A64 PREFS SETTINGS AND CONFIGURATION FILES ....................  3-1
  296.         THE MENUS .....................................................  3-2
  297.  
  298.         THE PROJECT MENU ..........................................  3-2
  299.                 RESET A64 .............................................  3-2
  300.             LOAD CONFIG ...........................................  3-2
  301.             SAVE CONFIG ...........................................  3-3
  302.             NAMING CONFIGURATION FILES ........................  3-3
  303.             RESET CONFIG ..........................................  3-4
  304.             ABOUT A64 .............................................  3-4
  305.             QUIT A64 ..............................................  3-4
  306.             EXIT PREFS ............................................  3-5
  307.  
  308.         THE SYSTEM MENU ...........................................  3-6
  309.             PAR PORT ..............................................  3-6
  310.             SER PORT ..............................................  3-6
  311.             MODEMS ............................................  3-7
  312.             GAME PORTS (JOYSTICKS) ................................  3-7
  313.             SWAP PORTS GADGET .................................  3-7
  314.                     PORT 1 AND PORT 2 GADGETS .........................  3-8
  315.             DRIVES ................................................  3-9
  316.             AMIGA DRIVES ......................................  3-10
  317.  
  318.         THE GRAFIX MENU ...........................................  3-11
  319.             COLORS ................................................  3-11
  320.             COLOR GADGETS .....................................  3-11
  321.             SLIDER GADGETS ....................................  3-12
  322.             COLOR MODE GADGET .................................  3-12
  323.                 20 COLOR MODE .................................  3-13
  324.                 16 COLOR MODE .................................  3-13
  325.  
  326.                                                                           4
  327.  
  328.  
  329.  
  330. -
  331.  
  332.  
  333.  
  334.                 2, 4, & 8 COLOR MODES .........................  3-14
  335.             BORDERS ...............................................  3-15
  336.             SCREEN REFRESH ........................................  3-16
  337.             DIRECT MODE .......................................  3-16
  338.             SAMPLE MODE .......................................  3-16
  339.  
  340.         THE TOOLS MENU ............................................  3-17
  341.             SAVE SCREEN ...........................................  3-17
  342.  
  343.         A64 PREFS NOTES ...............................................  3-18
  344.  
  345.     UTILITIES .........................................................  4-1
  346.         UTILITY SUMMARY ...............................................  4-1
  347.             CONVENTIONS FOR THE CLI BASED UTILITIES ...................  4-1
  348.         64Cmd .........................................................  4-3
  349.         64Dir .........................................................  4-4
  350.         64Print .......................................................  4-5
  351.         64Status ......................................................  4-6
  352.         64ToAmiga .....................................................  4-7
  353.         AmigaTo64 .....................................................  4-8
  354.         InstallA64Font ................................................  4-9
  355.         Pet2ASCII .....................................................  4-10
  356.         PrintFile .....................................................  4-11
  357.         StripLoadAddr .................................................  4-12
  358.         C64 PROGRAMS ..................................................  4-13
  359.             SaveROMs ..................................................  4-13
  360.             64Colors ..................................................  4-13
  361.  
  362.     TECHNICAL .........................................................  5-1
  363.          THE A64 PACKAGES FILE STRUCTURE ..............................  5-1
  364.          THE KEYBOARD .................................................  5-2
  365.          KEYBOARD DIFFERENCES .....................................  5-2
  366.          A PROBLEM WITH THE KEYBOARD ..............................  5-2
  367.          THE NUMERIC KEYPAD .......................................  5-2
  368.          UNUSED KEYS ..............................................  5-3
  369.          A64 AND MULTITASKING .........................................  5-4
  370.          A64 AND MEMORY ...............................................  5-4
  371.          680x0 SUPPORT ................................................  5-5
  372.          ROMS .........................................................  5-6
  373.              WHAT IS ROM? .............................................  5-6
  374.              THE C64'S ROMS ...........................................  5-6
  375.              A64'S ROMS ...............................................  5-6
  376.              INSTALLING THE C64'S ROMS ................................  5-7
  377.  
  378.       PROBLEMS AND SOLUTIONS ..........................................  6-1
  379.         A64 ERRORS ....................................................  6-2
  380.         ERROR LIST ................................................  6-3
  381.         INCOMPATIBILITIES .............................................  6-9
  382.         KNOWN BUGS ....................................................  6-10
  383.  
  384.       WHAT IS IN THE FUTURE ...........................................  7-1
  385.  
  386.       APPENDICES .......................................................   A
  387.           ERROR REPORT .................................................   A
  388.  
  389.  
  390.  
  391.  
  392.                                                                           5
  393.  
  394.  
  395.  
  396. -
  397.  
  398.  
  399.  
  400. INTRODUCTION
  401.  
  402.     Welcome to The A64 Package.  This manual assumes that you are familiar with
  403.     the basic usage of the CLI and WorkBench.  If you are not please consult
  404.     your Amiga user's guide.  This manual also makes the assumption that you
  405.     are familiar with using the Commodore 64.  If you want to learn more about
  406.     using the Commodore 64 there are many good books available on the subject.
  407.  
  408.     Throughout this manual some names are used that we would like to clarify.
  409.     When you see the name "The A64 Package" we are referring to the entire
  410.     package including all its utilities.  When you see the name "A64" by itself
  411.     we are referring only to the A64 program.  The names: "A64's hardware
  412.     interface","hardware interface" or just "interface" all refer to the same
  413.     interface.
  414.  
  415.     The bulk of this manual is for describing the use and function of A64.  The
  416.     descriptions and instructions for all of The A64 Packages' utilities can be
  417.     found in the UTILITIES section.  We recommend that you fully read this
  418.     manual before attempting to use any of the programs included with The A64
  419.     Package.
  420.  
  421.  
  422. WHAT IS THE A64 PACKAGE?
  423.  
  424.     The A64 Package is a collection of Amiga programs to help Commodore 64
  425.     users upgrade to the Amiga.  We like to call The A64 Package "a Commodore
  426.     64 upgrade kit."  Commodore 64 owners have spent hundreds or even thousands
  427.     of dollars on their C64 peripherals and software.  Many of them would like
  428.     to upgrade to the Amiga, but they do not want to lose their investment.
  429.     There is a solution!  The A64 Package will allow them to continue to use
  430.     their familiar Commodore 64 software and peripherals while they're learning
  431.     how to use their powerful, new Amiga.  The main program included with The
  432.     A64 Package is A64.  A64 is a Commodore 64 emulator.  The word emulate
  433.     means to strive to equal or excel, especially through imitation.  A64
  434.     emulates the Commodore 64.  This means that using A64 is just like using a
  435.     C64.  There are literally thousands of programs available for the Commodore
  436.     64 and A64 will run a majority of them.  The A64 Package also includes
  437.     several utilities to help with the transfer of data or programs from the
  438.     Commodore 64 to the Amiga and back again.  Now bridging the gap from the
  439.     Commodore 64 to the Amiga is easier than ever before.  The A64 Package
  440.     helps to make the upgrade path a little easier to take.
  441.  
  442.  
  443. WHAT IS NEEDED?
  444.  
  445.     The A64 Package is a hardware and software combination.  The software, the
  446.     A64 program and its associated utilities, perform the actual Commodore 64
  447.     emulation and allow you to transfer data or programs from C64 drives to
  448.     Amiga drives and back again.  The hardware is an interface that plugs into
  449.     the parallel port of your Amiga 500 or 2000 and allows The A64 Package to
  450.     access Commodore 64 disk drives and printers.  A separate adapter cable is
  451.     needed for the A1000.  You already have the software and the hardware is
  452.     available from QuesTronix.  You DO NOT need the hardware to use A64, but
  453.     without it, its use is very limited.  You DO need the hardware to use most
  454.     of The A64 Packages' utility programs.
  455.  
  456.  
  457.  
  458.                                                                         1-1
  459.  
  460.  
  461.  
  462. -
  463.  
  464.  
  465.  
  466. WHAT DOES IT COST?
  467.  
  468.     The software portion of The A64 Package is licensed to you.  You are free
  469.     to use and distribute it as long as certain terms are agreed to (See
  470.     LICENSE AGREEMENT on page 1).  One of these terms is that QuesTronix is
  471.     charging a license fee for the use of The A64 Package.  This license fee is
  472.     $25.00 (plus $3.00 for shipping and handling of the hardware interface).
  473.     Paying this license fee makes you a registered owner of The A64 Package and
  474.     grants you certain rights and privileges.  Also, after receiving the
  475.     license fee, from you, QuesTronix will send you the hardware interface that
  476.     is used with most of the programs in The A64 Package.
  477.  
  478.     The adapter cable needed for the A1000 is available for an additional
  479.     $20.00.  Please add $3.00 for shipping and handling if you order the
  480.     adapter cable separately.
  481.  
  482.  
  483. HOW TO BECOME A REGISTERED OWNER
  484.  
  485.     Included with The A64 Package is the file "Registration.form".  This file
  486.     serves as a registration form for The A64 Package.  Please print this file
  487.     (See PrintFile in the UTILITIES section) and then fill it out and send it
  488.     with a check or money order, for the license fee, to:
  489.  
  490.                                   QuesTronix
  491.                                 P.O. Box 340285
  492.                             Hartford, CT 06134-0285
  493.  
  494.     Funds must be drawn on a US bank.  Please allow 4-6 weeks for personal
  495.     checks to clear.  Sorry no CODs or charge cards.
  496.  
  497.     Please take the time to fill out the registration form completely.  The
  498.     information you put on it will help us to put out better updates of The
  499.     A64 Package.  Users without printers can substitute the registration form
  500.     with a letter. 
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                                                         1-2
  525.  
  526.  
  527.  
  528. -
  529.  
  530.  
  531.  
  532.  A NOTE FROM THE AUTHOR
  533.  
  534.     Those of you that have been around the Amiga community for a while know all
  535.     about C64 emulators and what a disappointment they have been.  I hope that
  536.     A64 is going to change that.  I decided to write A64 because I knew that a
  537.     C64 emulator could be faster and more compatible than the two commercially
  538.     available emulators.  Seeing how I was co-author of one of them (GO-64!),
  539.     I had a slight advantage in writing another emulator.  A64 V1.00n is the
  540.     first release in my attempt to write a better emulator and I see many
  541.     improvements and more features in the future.  Although I believe that The
  542.     A64 Package, in its current state, to be useful and in many ways superior
  543.     to the competitors packages, it still needs quite a bit of work to be the
  544.     best it can be.  Unfortunately writing a program as complex as a C64
  545.     emulator takes a great deal of time and for QuesTronix to continue
  546.     development of The A64 Package we needs your support.  If you find The A64
  547.     Package useful and would like to see it improve, send in the license fee.
  548.     I believe that the license fee is minimal.  Where else can you find a
  549.     quality Amiga hardware/software product for $25.00?
  550.  
  551.                             Thanks in advance,
  552.                             Cliff Dugan
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                                                         1-3
  591.  
  592.  
  593.  
  594. -
  595.  
  596.  
  597.  
  598. GETTING STARTED
  599.  
  600.     If you already have A64's hardware interface you should install it before
  601.     running A64 (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  602.     section).
  603.  
  604.  
  605. RUNNING A64
  606.  
  607.     To run A64 you should have:
  608.  
  609.         1. A copy of WorkBench that can be to written to.  You can either use
  610.            the WorkBench that you usually use with your Amiga or make a copy of
  611.            it.  If you decide to use your normal WorkBench you should note that
  612.            a font will be added to it and it should have enough room on it to
  613.            store this font (less than 1%).  You should make sure that the
  614.            WorkBench disk contains the following directories and files:
  615.  
  616.            "C" directory containing the files "Execute, Assign, Path and Copy"
  617.            "Libs" directory containing the file "diskfont.lib"
  618.            "Fonts" directory
  619.  
  620.         2. A separate disk containing The A64 Package, which should be in the
  621.        directory named "TheA64Package."
  622.  
  623.     Before you can run A64 you must install a font onto the WorkBench disk that
  624.     you will be using with The A64 Package.  This is easily done by using the
  625.     program "InstallA64Font" that is included with The A64 Package (See
  626.     InstallA64Font in the UTILITIES section).  The procedure for installing the
  627.     font, from the WorkBench, is as follows:
  628.  
  629.         1. Insert the disk containing The A64 Package into any drive.
  630.         2. Double-click The A64 Packages' disk icon. 
  631.         3. When the disk window appears double-click TheA64Package drawer icon.
  632.         4. When the drawer window appears you will see an icon that is named
  633.            "InstallA64Font," double-click this icon.
  634.         5. A window will appear asking you to enter the name of the drive
  635.            containing The A64 Package.  You should enter the name of drive and
  636.            press the RETURN key when you are done.  For example, if the drive
  637.            containing The A64 Package was drive 1 then you would enter: df1:
  638.            and then press return.
  639.         6. The A64 font will then be installed to your WorkBench fonts
  640.            directory.  If you have a single drive system just swap disks when
  641.            needed.
  642.  
  643.     To run InstallA64Font from the CLI, type the following:
  644.  
  645.         cd TheA64Package
  646.     run InstallA64Font
  647.  
  648.         You can now follow the procedure listed above, starting at step 5.
  649.  
  650.     The installation of the A64 Font only needs to be done once as long as you
  651.     always use the same WorkBench disk with A64.  If you change WorkBench disks
  652.     you will have to install the A64 Font on the new WorkBench disk.
  653.  
  654.  
  655.  
  656.                                                                         2-1
  657.  
  658.  
  659.  
  660. -
  661.  
  662.  
  663.  
  664.     After installing the A64 Font you are now ready to run A64.  If you still
  665.     have TheA64Package drawer window open from installing the A64 Font you can
  666.     go directly to step 4.
  667.  
  668.         1. Insert the disk containing The A64 Package into any drive.
  669.         2. Double-click The A64 Packages' disk icon. 
  670.         3. When the disk window appears double-click TheA64Package drawer icon.
  671.         4. You will see an icon named "A64" that looks like an Amiga 2000,
  672.            double-click it.
  673.         5. You will then see A64's title screen.  There will be a brief pause
  674.            while A64 loads its files.  After it's done loading you will see a
  675.            message flashing on the lower left hand side of the screen saying
  676.            "PRESS A MOUSE BUTTON."  At this time you should do so.
  677.         6. You will then be shown A64's license agreement screen.  You should
  678.            read this entire screen before proceeding.  If you agree to the
  679.            terms listed on the screen you should press the left mouse button to
  680.            enter A64.  If you do not agree to the terms you should press the
  681.            right mouse button to quit A64.
  682.  
  683.     To run A64 from the CLI, type the following:
  684.  
  685.         cd TheA64Package
  686.     run A64
  687.  
  688.         Make sure you type run before A64 to take advantage of A64's
  689.         multitasking capabilities.  You can now follow the procedure for
  690.         running A64 starting at step 5.
  691.  
  692.     Assuming you agreed to the terms of the license agreement and pressed the
  693.     left mouse button, you will now be shown the A64 BASIC screen.  The A64
  694.     BASIC screen will differ from the C64 BASIC screen in two ways:
  695.  
  696.        1. The startup message will say "*** QUESTRONIX A64 BASIC V1 ***"
  697.           instead of "**** COMMODORE 64 BASIC V2 ****."  This is because the
  698.           Commodore 64 ROMs are not present in A64 (See ROMS in the TECHNICAL
  699.           section).
  700.        2. There will be no borders around the screen. (See BORDERS in the
  701.           GRAFIX MENU section).
  702.  
  703.     You have now turned your Amiga into a C64.  You can do almost everything in
  704.     A64 that you would do on a C64.  You can try all the BASIC commands or POKE
  705.     and PEEK around memory. It's all there.
  706.  
  707.     NOTE: While the A64's title screen is being displayed you can press the
  708.           TAB key to cycle the background.  Pressing it again will stop the
  709.           cycling.
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                                                         2-2
  723.  
  724.  
  725.  
  726. -
  727.  
  728.  
  729.  
  730. A64'S HARDWARE INTERFACE
  731.  
  732.     To fully utilize The A64 Package you need its hardware interface.  This
  733.     interface is a small hardware box that plugs into the parallel port of
  734.     your Amiga 500 or 2000.  A separate adapter cable is required for the Amiga
  735.     1000.  This interface allows you to connect your Commodore 64 disk drive
  736.     and printers to the Amiga in the same way you would connect them to your
  737.     C64.  It's this interface that allows you to load and save C64 programs
  738.     from C64 disk drives and transfer them to and from Amiga disks.  The
  739.     hardware interface is not absolutely required to use A64, but without it,
  740.     its use is very limited.  To get the interface you must become a registered
  741.     owner of The A64 Package (See HOW TO BECOME A REGISTERED OWNER in the
  742.     INTRODUCTION section).
  743.  
  744.  
  745. INSTALLING A64'S HARDWARE INTERFACE
  746.  
  747.     The hardware interface is a small box with two connectors on it.  The large
  748.     connector is the end that plugs into your Amiga and the small connector is
  749.     the end where you plug in your C64 disk drives and printers. 
  750.  
  751.     To install the hardware interface use the following procedure:
  752.  
  753.     1. Make sure your Amiga is turned off.  You should NEVER plug anything into
  754.        your Amiga while it's turned on, because damage to your Amiga could
  755.        result by doing so.
  756.     2. If you have the Amiga 500 or 2000 you may now plug the interface
  757.        directly into its parallel port.  If you have the Amiga 1000 you must
  758.        first plug the adapter cable into the parallel port and then connect the
  759.        interface to the cable.  Please note that this adapter cable is not a
  760.        simple gender changer and only a cable specifically made to connect
  761.        A500/A2000 devices to an A1000 parallel port should be used.
  762.     3. You are now ready to connect your C64 disk drives and printers to the
  763.        interface.  Make sure that each C64 device that you wish to connect has
  764.        its power turned off.  Using the serial cable that came with your disk
  765.        drive or printer,  plug one end of the cable into the interface and the
  766.        other into your C64 peripheral.  The C64 peripherals may now be "daisy
  767.        chained" in the same way as they would be on a C64, by plugging each new
  768.        device into the back of each previous device.  After all C64 devices are
  769.        connected you can then turn them on.  A64 will support up to four
  770.        different C64 disk drives and two separate C64 printers, simultaneously.
  771.     4. You may now turn on your Amiga and boot it up as you normally would.
  772.  
  773.     The hardware interface can stay plugged in at all times without interfering
  774.     with any programs on your Amiga, as long as they do not use the parallel
  775.     port.  If you want to use your parallel port with some other piece of
  776.     hardware, like a printer or digitizer, you must remove the hardware
  777.     interface and install the other device as you normally would.  You can also
  778.     use an A-B switch and just switch between devices.  Please note that A64
  779.     takes over the parallel port and for the parallel port to be used by other
  780.     devices while A64 is running certain procedures must by followed (See PAR
  781.     PORT in the SYSTEM MENU section).
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                                                         2-3
  789.  
  790.  
  791.  
  792. -
  793.  
  794.  
  795.  
  796. INSTALLING THE A64 PACKAGE ON ANOTHER DISK OR HARD DISK
  797.  
  798.     To install The A64 Package on another floppy disk or hard disk all you need
  799.     to do is copy TheA64Package directory (drawer) to the disk you want to
  800.     install it on.  The way to do this is as follows:
  801.  
  802.     From the WorkBench:
  803.  
  804.        drag the TheA64Package drawer to the destination disk.
  805.  
  806.     From the CLI type:
  807.  
  808.        makedir <destination disk>TheA64Package
  809.        copy <source disk>TheA64Package <destination disk>TheA64Package all
  810.        copy <source disk>TheA64Package.info <destination disk>
  811.  
  812.     <source disk> is the disk containing TheA64Package directory and
  813.     <destination disk> is the disk you want to install The A64 Package on.
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.                                                                         2-4
  855.  
  856.  
  857.  
  858. -
  859.  
  860.  
  861.  
  862. A64 PREFS
  863.  
  864.     A64 Prefs utilizes an Intuition user interface with menus, requesters and
  865.     gadgets.  This manual assumes that you are familiar with using this type of
  866.     user interface and the terms used to describe it.  If you are not familiar
  867.     with them please consult your Amiga user's manual.
  868.  
  869.     A64 is the Amiga's first truly multitasking Commodore 64 emulator and A64
  870.     Prefs is your bridge, from A64, to the multitasking environment.  A64 Prefs
  871.     allows A64 to have features you've come to expect from Amiga programs, like
  872.     an Intuition user interface with menus and requesters.  A64 Prefs allows
  873.     you to change the way A64 is configured to run C64 programs, access tools
  874.     included with The A64 Package and, most importantly, it allows you to stop
  875.     any C64 program that A64 is currently running and return to the WorkBench,
  876.     after which you can use A64 Prefs and re-enter the C64 program and pick up
  877.     EXACTLY where you left off.  A64 Prefs gives A64 the power and flexibility
  878.     that, until now, no C64 emulator has had.
  879.  
  880.     To gain access to A64 Prefs from A64 press the [LEFT ALT] key and the
  881.     [RIGHT ALT] key simultaneously.  After doing so a title bar will appear on
  882.     the C64 program that is currently running.  At this point you can get back
  883.     to the Workbench or CLI by dragging the screen down or by depth arranging
  884.     the A64 Prefs screen by using the front-back gadgets.  To get back to A64
  885.     Prefs you do the same thing, drag or depth arrange any other screen that
  886.     may visible.  You can also use the following key sequences to depth arrange
  887.     the A64 Prefs screen with the Workbench screen:
  888.  
  889.     [LEFT AMIGA] [M]: Send Workbench to back, A64 Prefs to front
  890.     [LEFT AMIGA] [N]: Send Workbench to front, A64 Prefs to back
  891.  
  892.  
  893. A64 PREFS SETTINGS AND CONFIGURATION FILES
  894.  
  895.     A64 Prefs effects the operation of A64 much like the WorkBench Preferences
  896.     program effects the operation of the Amiga.  By changing A64 Prefs'
  897.     settings you can force A64 to change its performance or appearance, in the
  898.     way that it runs a C64 program.  All of A64 Prefs' settings are accessed
  899.     with menus and requesters.  When you change one or more of these settings
  900.     they become the current settings, meaning they will take effect immediately
  901.     or when A64 is re-entered.  These settings will stay in effect until you
  902.     change them again or until you quit A64.  You can also save all of A64
  903.     Prefs' settings in what is called a "configuration file."  Unlike the
  904.     WorkBench Preferences program, A64 Prefs allows you to create as many
  905.     different configuration files as you like and name them what ever you
  906.     choose.
  907.  
  908.     The procedure for changing A64 Prefs' settings and loading and saving
  909.     configuration files is detailed in THE MENUS section.
  910.  
  911.     NOTE: A64 has a default configuration file.  This file is named
  912.           "A64.config" and it is loaded anytime you run A64.  It contains all
  913.           of A64's initial settings, which are shown by A64Prefs' menus and
  914.           requesters.  By changing any one or more of A64 Prefs' settings and
  915.           saving them with the name "A64.config" will force A64 to use your new
  916.           settings as its initial settings.
  917.  
  918.  
  919.  
  920.                                                                         3-1
  921.  
  922.  
  923.  
  924. -
  925.  
  926.  
  927.  
  928. THE MENUS
  929.  
  930.     A64 Prefs is broken up into several menus.  Each having its own function
  931.     and options.  All of A64 Prefs settings and features are accessed with
  932.     these menus.  Each menu and its options are described in the following
  933.     sections.
  934.  
  935.  
  936. THE PROJECT MENU
  937.  
  938.  
  939. RESET A64
  940.  
  941.     KEY SEQUENCE: [LEFT AMIGA] [N] (New)
  942.  
  943.     The RESET A64 menu option allows you to reset A64 back to its initial
  944.     state.  If selected, this option will terminate the program that A64 is
  945.     currently running and return A64 to the BASIC startup screen.  Essentially,
  946.     this is the same thing as turning a Commodore 64 off and then on again.
  947.  
  948.     When selecting RESET A64 you will be prompted with a requester asking you
  949.     "Are sure you want to reset A64?".  Select one of the requester's gadgets
  950.     to answer the question:
  951.  
  952.         YES, Reset A64.
  953.  
  954.         NO, Abort the procedure.
  955.  
  956.     NOTES: RESET A64 is non-destructive.  Any programs that were in memory
  957.            before the reset will still be there after the reset.
  958.  
  959.            RESET A64 does not reset any devices connected with A64's hardware
  960.            interface (i.e., C64 disk drives and printers).  If you were using
  961.            a program that used copy protection and/or sent commands to the
  962.            devices you may have to reset them by turning them off and then on
  963.            again.
  964.  
  965.  
  966. LOAD CONFIG
  967.  
  968.     KEY SEQUENCE: [LEFT AMIGA] [L] (Load)
  969.  
  970.     The LOAD CONFIG menu option allows you to load a previously saved
  971.     configuration file.  If selected, this option will load the requested
  972.     configuration file and the newly loaded settings will become A64 Prefs'
  973.     current settings.
  974.  
  975.     When selecting LOAD CONFIG you will be prompted with a requester asking
  976.     you to enter the name of the configuration file you wish to load.  Use the
  977.     requester's string gadget to enter the name and then press the RETURN key
  978.     to load the file.  You can also use the requester's other gadgets to
  979.     select the following:
  980.  
  981.         OK, Load the configuration file (pressing RETURN does the same).
  982.  
  983.         CANCEL, Abort the procedure.
  984.  
  985.  
  986.                                                                         3-2
  987.  
  988.  
  989.  
  990. -
  991.  
  992.  
  993.  
  994.     NOTE: The filename can contain any legal AmigaDOS path name, limited to 31
  995.           characters in length.
  996.  
  997.     SEE:  A64 PREFS SETTINGS AND CONFIGURATION FILES and SAVE CONFIG in the
  998.           A64 PREFS section.
  999.  
  1000.  
  1001. SAVE CONFIG
  1002.  
  1003.     KEY SEQUENCE: [LEFT AMIGA] [S] (Save)
  1004.  
  1005.     The SAVE CONFIG menu option allows you to save the current A64 Prefs'
  1006.     settings.  If selected, this option will save all of A64 Prefs' current
  1007.     settings in the configuration file that you specified, to be loaded at a
  1008.     later time.
  1009.  
  1010.     When selecting SAVE CONFIG you will be prompted with a requester asking
  1011.     you to enter the name of the configuration file you wish to save A64
  1012.     Prefs' current settings to.  Use the requester's string gadget to enter the
  1013.     name and then press the RETURN key to save the file.  You can also use the
  1014.     requester's other gadgets to select the following:
  1015.  
  1016.         OK, Save the configuration file (pressing RETURN does the same).
  1017.  
  1018.         CANCEL, Abort the procedure.
  1019.  
  1020.     NOTES: The filename can contain any legal AmigaDOS path name, limited to 31
  1021.            characters in length.
  1022.  
  1023.            You can change the default A64 Prefs' settings, the settings used
  1024.            when A64 is first loaded, by saving the current settings with the
  1025.            name "A64.config".  This configuration file is always loaded
  1026.            whenever you run A64.
  1027.  
  1028.     SEE:   A64 PREFS SETTINGS AND CONFIGURATION FILES and LOAD CONFIG and
  1029.            NAMING CONFIGURATION FILES in the A64 PREFS section.
  1030.  
  1031.  
  1032. NAMING CONFIGURATION FILES
  1033.  
  1034.     It is a good practice to end your configuration files with the file
  1035.     extension ".config".  This will help you to remember what you named your
  1036.     configuration files.  For example, if you saved a configuration file for
  1037.     the C64 program "PrintShop" and you named it "PrintShop.config" then when
  1038.     loading the file at a future time you would have no problem remembering
  1039.     what you named it.
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.                                                                         3-3
  1053.  
  1054.  
  1055.  
  1056. -
  1057.  
  1058.  
  1059.  
  1060. RESET CONFIG
  1061.  
  1062.     KEY SEQUENCE: [LEFT AMIGA] [R] (Reset config)
  1063.  
  1064.     The RESET CONFIG menu option allows you to reset A64 Prefs' current
  1065.     settings to their default states.  If selected, this option will reset all
  1066.     of A64 Prefs' settings to their original settings.
  1067.  
  1068.     When selecting RESET CONFIG you will be prompted with a requester asking
  1069.     you "Are sure you want to reset config?".  Select one of the requester's
  1070.     gadgets to answer the question:
  1071.  
  1072.         YES, Reset the configuration settings.
  1073.  
  1074.         NO, Abort the procedure.
  1075.  
  1076.     NOTE: The default settings set by RESET CONFIG are not necessarily the ones
  1077.           currently saved in the default configuration file "A64.config".  If
  1078.           you have changed this file and you want to reset it to the default
  1079.           settings you must save them with the name "A64.config".
  1080.  
  1081.     SEE:  A64 PREFS SETTINGS AND CONFIGURATION FILES and SAVE CONFIG in the
  1082.           A64 PREFS section.
  1083.  
  1084.  
  1085. ABOUT A64
  1086.  
  1087.     KEY SEQUENCE: [LEFT AMIGA] [A] (About)
  1088.  
  1089.     The ABOUT A64 menu option allows you to read some information about A64.
  1090.  
  1091.     When selecting ABOUT A64 you will be shown a screen with a cycling blue
  1092.     background.  On the screen will be a requester with some information about
  1093.     A64.  After you have read the information you can select the requester's
  1094.     OK gadget to return to A64 Prefs.
  1095.  
  1096.  
  1097. QUIT A64
  1098.  
  1099.     KEY SEQUENCE: [LEFT AMIGA] [Q] (Quit)
  1100.  
  1101.     The QUIT A64 menu option allows you to quit A64.  If selected, this option
  1102.     will terminate A64 for good and return you to the WorkBench.
  1103.  
  1104.     When selecting QUIT A64 you will be prompted with a requester asking you
  1105.     "Are sure you want to quit A64?".  Select one of the requester's gadgets
  1106.     to answer the question:
  1107.  
  1108.         YES, Quit A64.
  1109.  
  1110.         NO, Abort the procedure.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.                                                                         3-4
  1119.  
  1120.  
  1121.  
  1122. -
  1123.  
  1124.  
  1125.  
  1126. EXIT PREFS
  1127.  
  1128.     KEY SEQUENCE: [LEFT AMIGA] [X] (eXit)
  1129.  
  1130.     The EXIT PREFS menu option will allow you to exit A64 Prefs and return to
  1131.     A64.  If selected, this option will close A64 Prefs and return you to A64
  1132.     at the exact point where you left it.
  1133.  
  1134.     When selecting EXIT PREFS you will be prompted with a requester asking you
  1135.     "Are sure you want to exit prefs?".  Select one of the requester's gadgets
  1136.     to answer the question:
  1137.  
  1138.         YES, Exit A64 Prefs and return to A64.
  1139.  
  1140.         NO, Abort the procedure.
  1141.  
  1142.     NOTE: You can get back to A64 Prefs by pressing the [LEFT ALT] key and the
  1143.           [RIGHT ALT] key simultaneously.
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.                                                                         3-5
  1185.  
  1186.  
  1187.  
  1188. -
  1189.  
  1190.  
  1191.  
  1192. THE SYSTEM MENU
  1193.  
  1194.  
  1195. PAR PORT
  1196.  
  1197. KEY SEQUENCE: None
  1198.  
  1199.     The PAR PORT menu option allows you to toggle ownership of the Amiga's
  1200.     parallel port between A64 and other Amiga programs.  Because A64 takes over
  1201.     the Amiga's parallel port for its hardware interface, it can only be used
  1202.     by either A64 or other Amiga programs at any one time.
  1203.  
  1204.     The PAR PORT menu option has two settings: AMIGA and A64. You can select
  1205.     one or the other of these settings and selecting one automatically
  1206.     unselects the other.  The current selected setting is shown by displaying
  1207.     a checkmark next to it.  To use A64's hardware interface, A64 must own the
  1208.     parallel port and the A64 setting must be selected.  If you want to use
  1209.     some other program, while A64 is running, that needs the parallel port for
  1210.     some other piece of hardware (i.e., parallel printers or digitizers) then
  1211.     the Amiga must own the parallel port and the AMIGA setting must be
  1212.     selected.
  1213.  
  1214.     NOTES: The A64 setting should only be selected when the A64 program itself
  1215.            needs the parallel port.  If you want to use the utility programs
  1216.            included with The A64 Package, that also need A64's hardware
  1217.            interface (i.e., 64Dir, 64ToAmiga, AmigaTo64, etc.), the AMIGA
  1218.            setting must be selected.
  1219.  
  1220.     IMPORTANT NOTE: See KNOWN BUGS in the PROBLEMS AND SOLUTIONS section!
  1221.  
  1222.  
  1223. SER PORT
  1224.  
  1225.     KEY SEQUENCE: None
  1226.  
  1227.     The SER PORT menu option allows you to toggle ownership of the Amiga's
  1228.     serial port between A64 and other Amiga programs.  Because A64 takes over
  1229.     the Amiga's serial port for using modems, it can only be used by either
  1230.     A64 or other Amiga programs at any one time.
  1231.  
  1232.     The SER PORT menu option has two settings: AMIGA and A64. You can select
  1233.     one or the other of these settings and selecting one automatically
  1234.     unselects the other.  The current selected setting is shown by displaying
  1235.     a checkmark next to it.  To use modems with A64, A64 must own the serial
  1236.     port and the A64 setting must be selected.  If you want to use some other
  1237.     program, while A64 is running, that needs the serial port for some other
  1238.     piece of hardware (i.e., serial printers or modems with Amiga programs)
  1239.     then the Amiga must own the serial port and the AMIGA setting must be
  1240.     selected.
  1241.  
  1242.     NOTE: You should not change the SER PORT setting to AMIGA while A64 is
  1243.           running a C64 telecommunications program.  This could cause the C64
  1244.           program to lose data and possibly crash, forcing you to reset A64.
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.                                                                         3-6
  1251.  
  1252.  
  1253.  
  1254. -
  1255.  
  1256.  
  1257.  
  1258. MODEMS
  1259.  
  1260.     A64 supports Amiga modems.  To use an Amiga modem with A64 you must make
  1261.     sure the SER PORT menu item is set to A64 (See SER PORT in the SYSTEM MENU
  1262.     section).  You do not have to set BAUD, PARITY or other telecommunications
  1263.     parameters with either A64 Prefs or the WorkBench Preferences program. The
  1264.     C64 program that A64 is running will set these parameters.  A64 does not
  1265.     support BAUD rates of 50 and 75 which are available on the C64, but it does
  1266.     support all common BAUD rates from 110 to 19200. 
  1267.  
  1268.    NOTE: A64's modem support is still in development and C64 telecommunications
  1269.          programs may or may not fully work.  For the best results with A64
  1270.          V1.00n try to use C64 programs that use the following settings: NO
  1271.          PARITY, 300 or 1200 BAUD, 1 STOP BIT, 8 DATA BITS and 3-LINE protocol.
  1272.          Modem support will be fully implemented by the next version of A64.
  1273.  
  1274.  
  1275. GAME PORTS (JOYSTICKS)
  1276.  
  1277.     KEY SEQUENCE: [LEFT AMIGA] [G] (Game port)
  1278.  
  1279.     The GAME PORTS menu option allows you to tell A64 what kind of input
  1280.     devices are connected to the Amiga's game ports (Game ports are the ports
  1281.     that you plug your Amiga mouse and joysticks into).
  1282.  
  1283.     In the following explanation of the GAME PORTS menu option, reference is
  1284.     made to each port in the following manner: port 1 means the port that your
  1285.     Amiga's mouse is normally plugged into and port 2 means the other port.  By
  1286.     default, port 1 on the Amiga corresponds to port 1 on the C64 and port 2 on
  1287.     the Amiga corresponds to port 2 on the C64.
  1288.  
  1289.     When selecting GAME PORTS, you will be prompted with a requester containing
  1290.     several gadgets. The function of each gadget is as follows:
  1291.  
  1292. SWAP PORTS GADGET 
  1293.  
  1294.     Selecting SWAP PORTS will toggle the game ports on the Amiga.  This is
  1295.     shown by toggling the gadget between YES and NO.  The meaning of both are
  1296.     as follows:
  1297.  
  1298.         NO, The Amiga's game ports act as normal. Port 1 on the Amiga
  1299.         corresponds to port 1 on the C64 and port 2 on the Amiga corresponds to
  1300.         port 2 on the C64.
  1301.  
  1302.         YES, The Amiga's game ports are swapped.  Port 1 on the Amiga will
  1303.         become port 2 on the C64 and port 2 on the Amiga will become port 1 on
  1304.         the C64.  This swapping of the ports is in reference to the actual
  1305.         game ports on the Amiga and not the PORT 1 and PORT 2 gadgets described
  1306.         below.
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.                                                                         3-7
  1317.  
  1318.  
  1319.  
  1320. -
  1321.  
  1322.  
  1323.  
  1324.    For example, you are using a C64 program that requires a joystick in port 1.
  1325.    Instead of unplugging your Amiga's mouse from port 1 you can plug the
  1326.    joystick into port 2 and select YES as the SWAP PORTS setting.  Now A64 will
  1327.    read the joystick as if it was plugged into port 1.  Please note that you
  1328.    must still set the PORT 1 gadget to JOYSTICKS as described below.  Also note
  1329.    that SWAP PORTS only effects how A64 reads the game ports and not how the
  1330.    Amiga and WorkBench read them.  With proper use, SWAP PORTS will allow you
  1331.    to use almost any C64 program and not have to unplug your Amiga's mouse,
  1332.    unless of course both game ports are required by the C64 program.
  1333.  
  1334. PORT 1 AND PORT 2 GADGETS
  1335.  
  1336.     Selecting PORT 1 or PORT 2 will allow you to change the input device for
  1337.     the corresponding C64 game port.  This is displayed by changing the name of
  1338.     the input device for the corresponding port.  Both of these gadgets work in
  1339.     the same way, except that PORT 1 corresponds to the C64's port 1 and PORT 2
  1340.     corresponds to the C64's port 2.  These gadgets ALWAYS correspond to the
  1341.     C64's game ports and not the Amiga's, regardless of the status of the SWAP
  1342.     PORTS gadget described above.  That means if a C64 program requires a
  1343.     joystick in port 1 you MUST set the PORT 1 gadget to JOYSTICKS.  Currently
  1344.     there are only two supported settings for these gadgets:
  1345.  
  1346.     JOYSTICKS: Selects joysticks for the corresponding C64 port.
  1347.  
  1348.     NO DEVICE: Acts as if there is no device connected regardless of what is
  1349.                actually plugged in.
  1350.  
  1351. OK GADGET
  1352.  
  1353.     Selecting OK will preserve all changes to the GAME PORTS settings.  They
  1354.     will become the current GAME PORTS settings and be active as soon as A64 is
  1355.     re-entered.
  1356.  
  1357. CANCEL GADGET
  1358.  
  1359.     Selecting CANCEL will ignore all changes to the GAME PORTS settings and
  1360.     abort the procedure.
  1361.  
  1362.     NOTES: While the PORT 1 gadget is set to JOYSTICKS and SWAP PORTS is set to
  1363.            NO the Amiga's mouse will interfere with the keyboard and characters
  1364.            will appear on the screen when the mouse is moved.  This is normal.
  1365.            The same thing will happen if you plug an Amiga mouse into port 1 of
  1366.            the C64.  This problem can be avoided by setting SWAP PORTS to YES
  1367.            or setting the PORT 1 gadget to NO DEVICE.  Also note, because of
  1368.            the way the SWAP PORTS gadget works this problem can also be created
  1369.            with the Amiga's game port 2.
  1370.  
  1371.            More input devices will be supported in future versions of A64.
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.                                                                         3-8
  1383.  
  1384.  
  1385.  
  1386. -
  1387.  
  1388.  
  1389.  
  1390. DRIVES
  1391.  
  1392.     KEY SEQUENCE: [LEFT AMIGA] [D] (Drives)
  1393.  
  1394.     The DRIVES menu option allows you to assign a type of disk drive to a drive
  1395.     number.  The Commodore 64 allows you to connect up to four disk drives to
  1396.     it.  A64 is no different in that it also allows you to utilize up to four
  1397.     drives, but unlike the C64, A64 allows you to use not only C64 drives, but
  1398.     you can also use Amiga drives.  The C64 uses drive numbers to access its
  1399.     drives.  Numbered 8-11.  A64 uses these same drive numbers and the DRIVES
  1400.     option allows you to assign a type of drive to them.
  1401.  
  1402.     When selecting DRIVES you will be prompted with a requester. On this
  1403.     requester you will see the numbers 8-11 on the left hand side of it.  These
  1404.     numbers correspond to the C64's drive numbers mentioned above.  To the
  1405.     right of each of these numbers are two gadgets.  The 1st gadget (going left
  1406.     to right) allows you to toggle between a C64 drive or an Amiga drive for
  1407.     that particular drive number.  This is displayed by showing the word C64 or
  1408.     AMIGA.  If you want to assign a C64 drive to a drive number you set this
  1409.     gadget to C64 and if you want to assign an Amiga drive to a drive number
  1410.     you set this gadget to AMIGA.  The second gadget is a string gadget and is
  1411.     only used when you the first gadget is set to AMIGA.  If you set the first
  1412.     gadget to C64 then this gadget will be disabled.  The purpose of the second
  1413.     gadget is to tell A64 what Amiga device you want to assign to a drive
  1414.     number.  This is done by typing in the device name that you want to assign
  1415.     to a drive number.  This name can be any Amiga drive or any valid AmigaDOS
  1416.     path name.  Some valid device names are: df0:, df1:, dh0:, and RAM:.  You
  1417.     can also use volume names like WorkBench 1.3: or directory names like
  1418.     df0:TheA64Package/64Prgs.
  1419.  
  1420.     For example, you want to load the C64 program named "64Colors" and this
  1421.     program is located on the The A64 Package disk in the 64Prgs directory,
  1422.     which itself is in the directory TheA64Package.  With the A64 disk in df0:
  1423.     you would do the following:
  1424.  
  1425.         1. Select the DRIVES menu option with either the mouse or key sequence.
  1426.         2. When the requester appears change drive 8 to AMIGA.  This is done by
  1427.            clicking on the first gadget (going left to right) next to the
  1428.            number 8.
  1429.         3. The string gadget will then become enabled.  Select the string
  1430.            gadget and type in the following:
  1431.  
  1432.                df0:The64Package/64Prgs [RETURN]
  1433.  
  1434.          4. Select the OK gadget so your changes will be preserved.
  1435.          5. Exit A64 Prefs using the EXIT PREFS menu item in the PROJECT menu.
  1436.          6. When you are back in A64 type in the following:
  1437.  
  1438.                 LOAD"64COLORS",8 [RETURN]
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.                                                                         3-9
  1449.  
  1450.  
  1451.  
  1452. -
  1453.  
  1454.  
  1455.  
  1456.     A64 will then load the program from the path you assigned to drive 8,
  1457.     "df0:The64Package/64Prgs."  You can now RUN the program as if were loaded
  1458.     from a C64 drive.  Now whenever you perform an action involving drive 8,
  1459.     A64 will act as if "df0:The64Package/64Prgs" is drive 8. Please note that
  1460.     you could also have assigned drive 8 to just df0: and typed the following
  1461.     when you re-entered A64:
  1462.  
  1463.                 LOAD"THEA64PACKAGE/64PRGS/64COLORS",8 [RETURN]
  1464.  
  1465.     The remaining two gadgets are as follows:
  1466.  
  1467.         OK will preserve all changes to the DRIVES settings. They will become
  1468.         the current DRIVES settings and be active as soon as A64 is re-entered.
  1469.  
  1470.         CANCEL will ignore all changes to the DRIVES settings and abort the
  1471.         procedure.
  1472.  
  1473.  
  1474. AMIGA DRIVES
  1475.  
  1476.     A64 supports Amiga drives for the loading and saving of programs and data
  1477.     to and from A64.  These drives can be floppy drives, hard drives and RAM
  1478.     drives.  But before you attempt to use any of these with A64 you must
  1479.     understand an important fact about using them.  They are not as compatible
  1480.     as using a C64 drive with A64 and their use is limited.  The reason for
  1481.     this is that C64 disk drives are what is referred to as "intelligent
  1482.     devices."  This means that C64 drives have ROM and RAM (memory) giving them
  1483.     the ability to run programs just like the C64 does.  Basically they are
  1484.     computers!  The C64 can transfer a program or send a command to the C64
  1485.     disk drive telling it to perform some internal action.  This action happens
  1486.     totally independent of the C64.  This ability is used for everything from
  1487.     reading drive errors to copy protection and FAST LOADERS.  Amiga drives on
  1488.     the other hand are not "intelligent devices."  They have no RAM or ROM and
  1489.     basically rely on the Amiga to perform all actions.  Because of this fact,
  1490.     Amiga drives will not work with most C64 copy protection and will not
  1491.     support any kind of communications meant for a C64 drive besides the simple
  1492.     reading and writing of programs and data.  If you try to perform some
  1493.     action with an Amiga drive that it can not handle an error requester will
  1494.     appear (See A64 ERRORS in the PROBLEMS AND SOLUTIONS section).  You can
  1495.     avoid these incompatibilities by using C64 disk drives whenever possible.
  1496.     A64 supports all communications with C64 disk drives and when using them
  1497.     these incompatibilities do not exist.
  1498.  
  1499.     NOTES: You can not do a directory of an Amiga disk from within A64. You
  1500.            must exit A64 to A64 Prefs and use the CLI to get the directory.
  1501.  
  1502.            Amiga drives will support reading and writing of the file types:
  1503.            PRG, SEQ and USR.  Relative (REL) files are not supported.  Please
  1504.            note that file types are not saved with the file on Amiga drives,
  1505.            but the file formats are identical to the C64's (PRG files include
  1506.            load address, SEQ and USR do not).
  1507.  
  1508.            In A64 V1.00n LOADING (reading) from Amiga drives is slow, even from
  1509.            RAM disks.  We do expect to dramatically increase the speed of LOADs
  1510.            in the future.
  1511.  
  1512.  
  1513.  
  1514.                                                                         3-10
  1515.  
  1516.  
  1517.  
  1518. -
  1519.  
  1520.  
  1521.  
  1522. THE GRAFIX MENU
  1523.  
  1524.  
  1525. COLORS
  1526.  
  1527.     KEY SEQUENCE: [LEFT AMIGA] [C] (Colors)
  1528.  
  1529.     The COLORS menu option allows you change A64's colors and the number of
  1530.     colors A64 uses to draw the C64's display.
  1531.  
  1532.     Before explaining the COLORS option we must first explain a little bit
  1533.     about the Commodore 64's colors and how it uses them.  The Commodore 64 is
  1534.     capable of displaying a maximum of 16 colors at any one time.  On the C64
  1535.     you are not able to change its colors, they are always displayed the same
  1536.     (Until now!).  The C64 uses numbers to signify its colors.  Seeing how
  1537.     there are 16 colors and computers start counting at 0, these color numbers
  1538.     range from 0 to 15.  The C64's color numbers and there corresponding colors
  1539.     are as follows:
  1540.  
  1541.     0 = BLACK    4 = PURPLE     8 = ORANGE    12 = MED GRAY
  1542.     1 = WHITE    5 = GREEN     9 = BROWN    13 = LGT GREEN
  1543.     2 = RED        6 = BLUE    10 = LGT RED    14 = LGT BLUE
  1544.     3 = CYAN    7 = YELLOW    11 = DARK GRAY    15 = LGT GRAY
  1545.  
  1546.     When selecting COLORS a screen will open at the bottom of the A64 Prefs
  1547.     screen.  This screen has many gadgets that allow you to control A64's
  1548.     colors.  The color screen's gadgets will be explained by separating them
  1549.     into sections.  Please note that most of the color screen's gadgets
  1550.     interact with each other.  If you change the setting of one gadget it will
  1551.     probably change the setting of one or more other gadgets, because of this
  1552.     we suggest that you read this section of the manual in order, without
  1553.     jumping from section to section.  The color screen's gadgets and their
  1554.     functions are as follows:
  1555.  
  1556. COLOR GADGETS
  1557.  
  1558.     The COLOR GADGETS are the 20 small gadgets that start at the top, left hand
  1559.     side of the screen. These gadgets represent A64's current color palette,
  1560.     with each gadget containing one of A64's colors.  These COLOR GADGETS allow
  1561.     you to select a color that you want to change.  The current selected gadget
  1562.     will be displayed with a red square around it.  You will note that there
  1563.     are 20 gadgets, while the C64 only has 16 colors.  This is because A64
  1564.     needs other colors, in addition to the C64's 16 colors, for some of it's
  1565.     COLOR MODES (COLOR MODES are discussed in the following sections).  To
  1566.     explain this we need to define what C64 colors are represented by each
  1567.     COLOR GADGET.  Going left to right, the first COLOR GADGET represents the
  1568.     C64's current background color.  The background color is the color of the
  1569.     screen that doesn't contains any graphics data, the transparent part of the
  1570.     screen.  For those of you that know a little about the C64's graphics, the
  1571.     background color is stored in the C64's color register at 53281.  The
  1572.     actual color this gadget contains depends on what COLOR MODE you are using.
  1573.     If you are using 16 or 20 COLOR MODE, this gadget will contain a mirror
  1574.     image of one of the C64's 16 colors (it will contain the same color as one
  1575.     of the other gadgets).  If you are using one of the other COLOR MODES: 2,
  1576.     4, or 8, then it will contain it's own independent color.  The next 16
  1577.     gadgets represent the C64's 16 colors, with the first gadget representing
  1578.     the C64's color 0 and the last gadget, of the 16, representing the C64's
  1579.  
  1580.                                                                         3-11
  1581.  
  1582.  
  1583.  
  1584. -
  1585.  
  1586.  
  1587.  
  1588.     color 15. The last three color gadgets are only used for A64's 20 COLOR
  1589.     MODE.  They represent three of the C64's color registers that are used for
  1590.     two of it's graphics modes.  For the people who know a little bit about the
  1591.     C64's graphics, the C64 color registers are at 53282-53284 and are used for
  1592.     multicolor text and extended background color text modes.  These three
  1593.     gadgets are like the background color gadget and will contain a mirror
  1594.     image of one of the C64's 16 colors.
  1595.  
  1596.     NOTES: The four gadgets described above, the background color gadget and
  1597.            the three gadgets used by 20 COLOR MODE, are different from the
  1598.            other 16 COLOR GADGETS.  While the other 16 COLOR GADGETS represent
  1599.            actual C64 colors that the C64 can not change, these four gadgets
  1600.            represent color registers within the C64 that can be changed to any
  1601.            one of its 16 colors.  Seeing how the C64 can change the color in
  1602.            these registers, thus changing the color in the gadgets that
  1603.            represent them, any changes you make to these gadgets will be
  1604.            temporary.  If you want to change one of these four gadgets and have
  1605.            its color preserved when A64 is re-entered you must find the other
  1606.            gadget (in the other 16 gadgets) that contains the same color as the
  1607.            gadget you want to change and then modify that gadget to the color
  1608.            you want.  For example, using the default C64 colors, the background
  1609.            color gadget will contain the color blue and will be a mirror image
  1610.            of the seventh COLOR GADGET, which will also contain the color blue.
  1611.            If you change the color of the seventh COLOR GADGET to white and
  1612.            then re-enter A64, the background color will be changed to white,
  1613.            the color you selected in the seventh COLOR GADGET.  If you had only
  1614.            changed the color in the background color gadget and re-entered A64
  1615.            the background color would be changed back to blue, the color in the
  1616.            seventh COLOR GADGET.
  1617.       
  1618.            When selecting a COLOR MODE of less than 20, all unused COLOR
  1619.            GADGETS will be disabled.
  1620.  
  1621. SLIDER GADGETS
  1622.  
  1623.     The SLIDER GADGETS are the three long, multicolored gadgets located below
  1624.     the COLOR GADGETS.  These gadgets are used to change A64's colors.  More
  1625.     specifically, they allow you to change the color contained in the selected
  1626.     COLOR GADGET.  On the Amiga, colors are formed by adding a combination of
  1627.     RED, GREEN and BLUE color parts.  These SLIDER GADGETS represent these
  1628.     three color parts with; RED on top, GREEN in the middle and BLUE on the
  1629.     bottom.  Each one of these gadgets contain 16 different colors.  By
  1630.     selecting one of these colors you will change the selected COLOR GADGET to
  1631.     that color.  You will note that every time you select a color that all the
  1632.     colors in the SLIDER GADGETS will change, this is to show what new colors
  1633.     are available within a certain range from the color you just selected.  All
  1634.     of the Amiga's 4096 possible colors can be achieved by changing the
  1635.     settings of these three gadgets.
  1636.  
  1637. COLOR MODE GADGET
  1638.  
  1639.     The COLOR MODE gadget is the located at the top, right hand side of the
  1640.     color screen.  It is shown by the words "COLOR MODE:" followed by a gadget
  1641.     containing a number.  This gadget allows you to pick how many colors A64
  1642.     will use to draw the C64 display.  The possible settings are: 2, 4, 8, 16
  1643.     and 20.  Each setting corresponds to the number of colors that A64 will
  1644.     use.  These color modes also relate to how many bitplanes are used to make
  1645.  
  1646.                                                                         3-12
  1647.  
  1648.  
  1649.  
  1650. -
  1651.  
  1652.  
  1653.  
  1654.     the C64 display.  The Amiga uses bitplanes to make up its screens (You do
  1655.     not need to fully understand bitplanes to grasp this example, but what you
  1656.     should understand is that the more bitplanes that are used, the more colors
  1657.     that can be displayed at one time and the more work A64 has to do to
  1658.     display them.  By lowering the number of bitplanes, we lower the number of
  1659.     available color, but also decrease the amount of work A64 has to do to draw
  1660.     the screen, resulting in A64 running faster). The following chart shows you
  1661.     how many colors the Amiga is capable of displaying for a certain number of
  1662.     bitplanes and how many colors A64 will display for the same number of
  1663.     bitplanes:
  1664.  
  1665.     NUMBER OF    NUMBER OF    NUMBER OF
  1666.     BITPLANES    AMIGA COLORS    A64 COLORS
  1667.     ---------    ------------    ----------
  1668.             1              2             2
  1669.             2              4             4
  1670.             3              8             8
  1671.             4             16             16
  1672.             5             32             20
  1673.  
  1674. 20 COLOR MODE
  1675.  
  1676.     There are only 16 colors on the C64, but because of differences in the way
  1677.     that the Amiga and the C64 make their screens A64 uses more than 16 colors
  1678.     to display all of the C64's colors.  In addition to the C64's 16 colors,
  1679.     A64 needs one color for the background color and it also uses three
  1680.     additional colors for two of its graphics modes (See COLOR GADGETS in the
  1681.     COLORS section).  That brings our total up to 20 colors needed for A64 to
  1682.     draw the C64's screen. That's how we get 20 COLOR MODE.  When using this
  1683.     COLOR MODE A64 can replicate the C64's screen perfectly.  The confusion
  1684.     starts when we start changing the COLOR MODE and lowering the number of
  1685.     bitplanes.  When we start lowering the COLOR MODE, we start losing colors.
  1686.     A64 handles this slightly different for 16 COLOR MODE than it does for the
  1687.     2, 4 & 8 COLOR MODES.  We will explain this by separating 16 COLOR MODE
  1688.     from the 2, 4 & 8 COLOR MODES and explaining them separately.
  1689.  
  1690. 16 COLOR MODE
  1691.  
  1692.     With 16 COLOR MODE A64 uses four bitplanes.  This allows us to have a 
  1693.     maximum of 16 colors, exactly the number the C64 has, but remember, A64
  1694.     needs other colors.  A64 needs a maximum of 20 colors and we now only have
  1695.     16, four colors short.  A64 handles this by replacing the missing colors
  1696.     with other available colors.  The first colors A64 can replace are the
  1697.     three colors mentioned above, that were needed for two of A64's graphics
  1698.     modes.  These three colors are only used for 20 COLOR MODE and can be
  1699.     ignored for all other COLOR MODES.  Getting rid of these three colors
  1700.     brings our total colors, needed by A64, down to 17.  This still leaves us
  1701.     with one color too many.  The way A64 handles this, is to replace one of
  1702.     the C64's colors.  A64 replaces the C64's color 15 (light gray) with the
  1703.     C64's color 1 (white).  This means, when using 16 COLOR MODE, whenever
  1704.     something is supposed to be displayed in color 15 it will be displayed in
  1705.     color 1.  This replacement was picked, because the default color 1 (white)
  1706.     looks very close to the default color 15 (light gray).  For all practical
  1707.     purposes, this is the only difference between 16 COLOR MODE and 20 COLOR
  1708.     MODE.  With 16 COLOR MODE all colors will look the way they should, except
  1709.     color 15 will be replaced with color 1.
  1710.  
  1711.  
  1712.                                                                         3-13
  1713.  
  1714.  
  1715.  
  1716. -
  1717.  
  1718.  
  1719.  
  1720. 2, 4 & 8 COLOR MODES
  1721.  
  1722.     The remaining three COLOR MODES: 2, 4 & 8, are all handled by A64 in the
  1723.     same way.  With these COLOR MODES A64 must replace more colors, the lower
  1724.     the color mode, the more colors that need to be replaced.  The way A64 does
  1725.     this is by taking the number of allowed colors (the COLOR MODE number) and
  1726.     reserving one color for the background color and using the remaining colors
  1727.     for the C64 colors.  Because of the limited number of colors provided by
  1728.     these COLOR MODES A64 sets aside one color for the background color that
  1729.     will be different than all the remaining colors, this is slightly different
  1730.     than the 20 & 16 color modes, where the background color is always a copy
  1731.     of one of the C64's colors. For example, in 8 COLOR MODE, A64 uses 1 color
  1732.     for the background color, leaving 7 colors free for C64 colors. In 4 COLOR
  1733.     MODE, A64 uses 1 color for the background color, leaving 3 colors free for
  1734.     C64 colors and in 2 COLOR MODE A64 uses 1 color for the background color,
  1735.     leaving 1 color free for C64 colors (this is the equivalent of a monochrome
  1736.     mode).  The following chart shows what colors are replaced by these COLOR
  1737.     MODES:
  1738.  
  1739.         The 2, 4 & 8 COLOR MODE numbers correspond to the COLOR GADGETS
  1740.         starting with the second gadget in, from the left (skip the 1st color
  1741.         gadget, the background color gadget). 
  1742.  
  1743.         C64 COLOR    8 COLOR MODE    4 COLOR MODE    2 COLOR MODE
  1744.         ---------    ------------    ------------    ------------
  1745.             0                1               1               1
  1746.             1                2               2               1
  1747.             2                3               3               1
  1748.             3                4               1               1
  1749.             4                5               2               1
  1750.             5                6               3               1
  1751.             6                7               1               1
  1752.             7                1               2               1
  1753.             8                2               3               1
  1754.             9                3               1               1
  1755.            10                4               2               1
  1756.            11                5               3               1
  1757.            12                6               1               1
  1758.            13                7               2               1
  1759.            14                1               3               1
  1760.            15                2               1               1
  1761.  
  1762.     The different COLOR MODES supported by A64 may seem very confusing, but
  1763.     they are really not that complicated once you start using them.  Included
  1764.     with The A64 package is a C64 program named "64Colors."  It is located in
  1765.     the directory "64Prgs."  We suggest you use this program and experiment
  1766.     with the different COLOR MODES to see their effect on the C64's colors.
  1767.  
  1768.     NOTES: Each COLOR MODE has its own color palette containing the number of
  1769.            colors supported by the COLOR MODE (i.e., 16 COLOR MODE has its own
  1770.            palette of 16 colors).  When changing COLOR MODES the new COLOR
  1771.            MODE's palette will be switched in and the previous palette, and any
  1772.            changes you made to it, will be preserved.  This is the same as if
  1773.            you had selected the OK gadget for the changes, so before changing
  1774.            COLOR MODES make sure any colors that you changed are they way you
  1775.            want them.
  1776.  
  1777.  
  1778.                                                                         3-14
  1779.  
  1780.  
  1781.  
  1782. -
  1783.  
  1784.  
  1785.  
  1786.            The drawing of the C64's screen is the most time consuming part of
  1787.            A64.  The general rule is that the more graphics a C64 program uses,
  1788.            the more work A64 has to do to display them and the slower A64 will
  1789.            run the C64 program.  You can help compensate for this extra work,
  1790.            by lowering the COLOR MODE.  When you lower the COLOR MODE you
  1791.            decrease the number of bitplanes that A64 has to draw to making A64
  1792.            run faster.  We strongly recommend that you lower the COLOR MODE to
  1793.            at least 16 whenever possible.  16 COLOR MODE will handle most C64
  1794.            programs with no dramatic decrease in color resolution.  Also note
  1795.            that if you are running an A1000 with 512k or an A500 or A2000 with
  1796.            1mb or less, selecting 16 COLOR MODE, which eliminates the 5th
  1797.            bitplane, will give you a more noticeable speed increase.
  1798.  
  1799. OK GADGET
  1800.  
  1801.     Selecting OK will preserve all changes to the COLORS settings. They will
  1802.     become the current COLORS settings and become active immediately.
  1803.  
  1804. CANCEL GADGET
  1805.  
  1806.     Selecting CANCEL will ignore all changes to the current COLORS settings in
  1807.     the current COLOR MODE and abort the procedure.  CANCEL will not cancel out
  1808.     changes to the COLOR MODE setting itself nor will it restore changes made
  1809.     to another COLOR MODES' colors.
  1810.  
  1811.     NOTES: When the A64 Colors screen is open the A64 Prefs screen will become
  1812.            "locked" and you will not be able to access any of A64 Prefs menus
  1813.            until you close the A64 Colors screen (when A64 Prefs screen is
  1814.            locked it will say "SCREEN LOCKED" on its title bar).
  1815.  
  1816.            A64 COLORS is still in the early stages of development.  Future
  1817.            versions of it will have many more features that you would expect
  1818.            from a color selection screen of this type (i.e., COPY, SWAP,
  1819.            SPREAD, etc.).  Also, the proportional gadgets response will be
  1820.            much faster (these are the sliding gadgets at the left of the screen
  1821.            that allow you to change colors).
  1822.  
  1823.  
  1824. BORDERS
  1825.  
  1826.     KEY SEQUENCE: None
  1827.  
  1828.     The BORDERS menu option allows you to toggle the C64's borders on and off.
  1829.     Because the Amiga does not support a true border around its screen, a
  1830.     border around the entire C64 screen can not be emulated efficiently.  To
  1831.     support programs that need borders, for such things as changing the border
  1832.     color to signify some status within the program, A64 supports a border on
  1833.     the top and bottom of the screen.  Changing the status of the borders will
  1834.     have no effect on the operation of A64, but may make some programs look
  1835.     better.
  1836.  
  1837.     The BORDERS menu option has two settings: ON and OFF.  You can select one
  1838.     or the other of these settings and selecting one automatically unselects
  1839.     the other.  The current selected setting is shown by displaying a checkmark
  1840.     next to it.  To turn the on borders, select ON, and to turn the borders
  1841.     off, select OFF.
  1842.  
  1843.     NOTE: The borders will not be visible until re-entering A64.
  1844.                                                                         3-15
  1845.  
  1846.  
  1847.  
  1848. -
  1849.  
  1850.  
  1851.  
  1852. SCREEN REFRESH
  1853.  
  1854.     KEY SEQUENCE: None
  1855.  
  1856.     The SCREEN REFRESH menu option allows to change the way A64 draws the C64
  1857.     screen.  A64 supports two ways of drawing the C64 screen, each having its
  1858.     own advantages and disadvantages.  The two ways A64 can draw the C64's
  1859.     screen are as follows:
  1860.  
  1861. DIRECT MODE
  1862.  
  1863.     When A64 is in DIRECT MODE it writes to the Amiga's screen directly.  This
  1864.     means, when the C64 is performing an operation that changes some part of
  1865.     the C64's screen A64 make the same change immediately to the Amiga's
  1866.     screen.  This way of drawing directly to the Amiga's screen has the
  1867.     advantage of showing changes of the C64's screen immediately resulting in
  1868.     smoother screen updates, but has the disadvantage of having the tendency
  1869.     to slow down A64 when alot of changes are happening to the C64's screen
  1870.     seemingly at one time. For example, scrolling in games.  DIRECT MODE is
  1871.     the default setting for the way A64 draws the screen and it is suggested
  1872.     that you use this setting for most C64 programs.
  1873.  
  1874. SAMPLE MODE
  1875.  
  1876.     When A64 is in SAMPLE MODE it draws the changes in the C64 screen at a set
  1877.     SAMPLE rate.  This means that A64 will SAMPLE the C64 graphics a couple of
  1878.     times per second to see what has changed and then draw the changes.  This
  1879.     way of drawing the screen, by taking samples of the C64 graphics, has the
  1880.     advantage of being faster when alot of changes are happening to the C64's
  1881.     screen seemingly at one time.  For example, scrolling in games, but has the
  1882.     disadvantage of making the screen updates appear jerky and at times out of
  1883.     sequence.  When using C64 programs that are real graphics intensive you can
  1884.     select SAMPLE MODE to make them run faster.
  1885.  
  1886.     The SCREEN REFRESH menu option has two settings: SAMPLE and DIRECT which
  1887.     represent the two modes described above.  You can select one or the other
  1888.     of these settings and selecting one automatically unselects the other.  The
  1889.     current selected setting is shown by displaying a checkmark next to it.
  1890.     Select SAMPLE for SAMPLE MODE and select DIRECT for DIRECT MODE.
  1891.  
  1892.     NOTE: There are times in A64 when SAMPLE MODE will override DIRECT MODE,
  1893.           because SAMPLE MODE can perform the screen updates more efficiently. 
  1894.           When you are running a C64 program that uses a graphics technique
  1895.           called "raster interrupts" and more than one graphics mode is used at
  1896.           one time SAMPLE MODE will automatically be selected, regardless of
  1897.           the menu option setting.
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.                                                                         3-16
  1911.  
  1912.  
  1913.  
  1914. -
  1915.  
  1916.  
  1917.  
  1918. THE TOOLS MENU
  1919.  
  1920.  
  1921. SAVE SCREEN
  1922.  
  1923.     KEY SEQUENCE: [F1]
  1924.  
  1925.     The SAVE SCREEN menu option allows you to save the currently displayed C64
  1926.     screen as an IFF file.  After saving the screen you can then load it into
  1927.     any Amiga graphics program that supports IFF pictures, like Deluxe Paint.
  1928.  
  1929.     When selecting SAVE SCREEN you will be prompted with a requester asking you
  1930.     to enter the name of the file you wish to save the screen as.  Use the
  1931.     requester's string gadget to enter the name and then press the RETURN key
  1932.     to save the file.  You can also use the requester's other gadgets to select
  1933.     the following:
  1934.  
  1935.         OK, Save the screen. (Pressing RETURN does the same.)
  1936.  
  1937.         CANCEL, Abort the procedure.
  1938.  
  1939.     NOTE: The filename can contain any legal AmigaDOS path name, limited to 31
  1940.           characters in length.
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.                                                                         3-17
  1977.  
  1978.  
  1979.  
  1980. -
  1981.  
  1982.  
  1983.  
  1984. A64 PREFS NOTES
  1985.  
  1986.     This section contains miscellaneous information about A64 Prefs that did
  1987.     not fit into other sections of the manual.
  1988.  
  1989.     When in A64 Prefs you can press [F10] to toggle the title bar on and off.
  1990.  
  1991.     When A64 is running some programs and you bring up A64 Prefs, you may
  1992.     notice some images disappear from the C64 screen, this is normal. These
  1993.     images are called "sprites."  Sprites are independent graphics images and
  1994.     not part of the screen in the normal sense.  Because A64 Prefs does not
  1995.     support C64 sprites, they will disappear from the screen when it is
  1996.     entered.  An example of a sprite is the Amiga's mouse pointer.
  1997.  
  1998.     When A64 is running some programs and you bring up A64 Prefs, you may
  1999.     notice the background changes color, this is normal.  This can happen if a
  2000.     C64 program is using a graphics technique called "raster interrupts" and
  2001.     the background color is different in areas on the same screen.  Because A64
  2002.     Prefs does not support multiple background colors on the same screen, as
  2003.     A64 does, it will display the last background color used for its background
  2004.     color.
  2005.  
  2006.     You should never attempt to bring up A64 Prefs while I/O (INPUT/OUTPUT) is
  2007.     in progress.  This means that whenever A64 is loading or saving from a disk
  2008.     drive, accessing a modem or using a printer, you should wait until the
  2009.     operation is completed before bringing up A64 Prefs.  This warning should
  2010.     especially be noted when accessing C64 devices.  Bringing up A64 during
  2011.     I/O should not "crash" A64, but may result in a "C64 crash" forcing you to
  2012.     reset A64 and/or the C64 devices that you interrupted.  To be on the safe
  2013.     side you should heed this warning.
  2014.  
  2015.     If at anytime you try to bring up A64 Prefs and the title bar does not
  2016.     appear and/or the screen goes blank this means A64 Prefs has not yet been
  2017.     entered correctly.  The most likely cause of this is the Amiga has brought
  2018.     up a  system requester on the WorkBench screen.  You must clear this
  2019.     requester before A64 Prefs will be entered correctly.  To do this, follow
  2020.     this procedure:
  2021.  
  2022.         1. Use the following key sequence to get access to the WorkBench
  2023.            screen:
  2024.  
  2025.                [LEFT AMIGA] [N]: Send Workbench to front, A64 Prefs to back
  2026.  
  2027.         2. Perform the action requested by the requester or select CANCEL.
  2028.         3. If A64 Prefs does not appear automatically after handling the
  2029.             requester use the following key sequence or depth arrange the
  2030.             WorkBench screen to get to A64 Prefs:
  2031.  
  2032.                [LEFT AMIGA] [M]: Send Workbench to back, A64 Prefs to front
  2033.  
  2034.         NOTE: If there is not a system requester on the WorkBench screen then
  2035.               A64 is stuck somewhere and you will have to reboot your Amiga to
  2036.               get everything back to normal.  Every precaution has been taken
  2037.               to make sure this doesn't happen.
  2038.  
  2039.  
  2040.  
  2041.  
  2042.                                                                         3-18
  2043.  
  2044.  
  2045.  
  2046. -
  2047.  
  2048.  
  2049.  
  2050. UTILITIES
  2051.  
  2052.     The A64 Package comes with a number of utility programs serving a variety
  2053.     of functions.  The majority of these utility programs are for helping with
  2054.     the transfer of C64 programs and data to the Amiga.  These utilities allow
  2055.     you to access C64 disk drives and printers directly from AmigaDOS and most
  2056.     of them must be run from the CLI.  In the following sections we will
  2057.     outline each utility and how to use it. 
  2058.  
  2059.  
  2060. UTILITIES SUMMARY
  2061.  
  2062.     The following list gives a brief summary of the utilities included with
  2063.     The A64 Package.  A couple of the headings need explanation.  The heading
  2064.     HDW is short for HarDWare interface and is used to signify if the utility
  2065.     directly needs A64's hardware interface.  The heading ENV is short for
  2066.     ENVironment and is used to state what environment the utility is to be used
  2067.     in.  The different environments are: WB - the utility is meant to be used
  2068.     with the WorkBench, but can also be used from the CLI, CLI - the utility
  2069.     is used from the CLI only, C64 - the utility is meant to be used on the
  2070.     C64, and A64 - the utility can be used by both A64 and the C64.  Please
  2071.     note that the utilities with their environment set to C64 or A64 are
  2072.     actual Commodore 64 programs, all other utilities are Amiga programs. Also
  2073.     note that just because a utility does not use the hardware interface
  2074.     directly does not mean that the utility will be useful without it.  For
  2075.     example the utility "Pet2ASCII" will convert a file from PetASCII to ASCII,
  2076.     but to use it you must first transfer a C64 program to an Amiga disk.
  2077.  
  2078.     UTILITY NAME    HDW    ENV    FUNCTION
  2079.     ------------    ---    ---    --------
  2080.     64Cmd        YES    CLI    Send a command to a C64 drive
  2081.     64Dir        YES    CLI    Read the dir of a C64 drive
  2082.     64Print        YES    CLI    Print an Amiga file to a C64 printer
  2083.     64Status            YES    CLI    Read a C64 drives' status
  2084.     64ToAmiga            YES    CLI    Copy a file from a C64 drive to an
  2085.                                         Amiga drive
  2086.     AmigaTo64            YES    CLI    Copy a file from an Amiga drive to a
  2087.                                         C64 drive
  2088.     InstallA64Font    NO    WB    Install A64's font to FONTS:
  2089.     Pet2ASCII            NO    CLI    Convert a file from PetASCII to ASCII
  2090.     PrintFile            NO    WB    Print an Amiga file to an Amiga printer
  2091.     StripLoadAddr    NO    CLI    Strip the load address from a file
  2092.  
  2093.     64Colors            NO    A64    View the C64's colors
  2094.     SaveROMs            NO    C64    Save the C64's ROMs
  2095.  
  2096.  
  2097. CONVENTIONS FOR THE CLI BASED UTILITIES
  2098.  
  2099.     Here are some general conventions for using the CLI based utilities that
  2100.     will help make them easier to use:
  2101.  
  2102.     For all the CLI based utilities except one, 64Status, you may enter the
  2103.     utilities name alone to get it's usage (for 64Status enter ? after its name
  2104.     to get its usage).
  2105.  
  2106.         For example, if you type: 64ToAmiga [RETURN]
  2107.  
  2108.                                                                         4-1
  2109.  
  2110.  
  2111.  
  2112. -
  2113.  
  2114.  
  2115.  
  2116.         The utility will print a short copyright message followed by a usage
  2117.         line that shows the syntax of the input that the utility expects.  A
  2118.         usage line appears like this:    
  2119.  
  2120.         Usage: 64ToAmiga <source filename> <destination filename> [file type]
  2121.  
  2122.     A utilities usage line shows what parameters are needed by the utility and
  2123.     incloses these parameters with symbols:
  2124.  
  2125.         When you see a parameter inclosed in < > this parameter is required by
  2126.         the utility and must be entered for the utility to function properly.
  2127.  
  2128.         When you see a parameter inclosed in [ ] this parameter is optional. If
  2129.         you don't enter anything for this parameter the utility will use some
  2130.         default value for it.
  2131.  
  2132.     NOTE: When using the CLI commands that require A64's hardware interface
  2133.           you should make sure the interface and the correct device for the
  2134.           utility is connected before attempting to use the utility.  Failing
  2135.           to do this can lock-up your Amiga.
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.                                                                         4-2
  2175.  
  2176.  
  2177.  
  2178. -
  2179.  
  2180.  
  2181.  
  2182. 64Cmd
  2183.  
  2184.     PURPOSE:     Send a command to a C64 disk drive
  2185.  
  2186.     USAGE:       64Cmd <command string> [drive]
  2187.                      <command string> is a valid C64 drive command string.
  2188.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2189.                          df11:.  df8: is the default.
  2190.  
  2191.     ENVIRONMENT: CLI
  2192.  
  2193.     INTERFACE:   YES
  2194.  
  2195.     64Cmd will allow you to send a command to a C64 disk drive.  It supports
  2196.     all of the standard Commodore DOS commands.  Some examples of using 64Cmd
  2197.     are:
  2198.  
  2199.         FORMAT:   Format a disk
  2200.         USAGE:    64Cmd N0:<disk name>,<2 digit id> [C64 drive]
  2201.         EXAMPLE:  64Cmd N0:testdisk,64 df8:
  2202.  
  2203.         SCRATCH:  Delete a file
  2204.         USAGE:    64Cmd S0:<filename> [C64 drive]
  2205.         EXAMPLE:  64Cmd S0:testfile df8:
  2206.  
  2207.         RENAME:   Rename a file
  2208.         USAGE:    64Cmd R0:<new name>=<old name> [C64 drive]
  2209.         EXAMPLE:  64Cmd R0:testfile2=testfile1 df8:
  2210.  
  2211.     For more information on C64 drive commands see your 1541 disk drive user's
  2212.     manual.
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.                                                                         4-3
  2241.  
  2242.  
  2243.  
  2244. -
  2245.  
  2246.  
  2247.  
  2248. 64Dir
  2249.  
  2250.     PURPOSE:     Get a directory listing of a C64 disk
  2251.  
  2252.     USAGE:       64Dir <search string> [drive]
  2253.                      <search string> is a valid C64 search string.
  2254.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2255.                          df11:.  df8: is the default.
  2256.  
  2257.     ENVIRONMENT: CLI
  2258.  
  2259.     INTERFACE:   YES
  2260.  
  2261.     64Dir will allow you to get a directory of a C64 disk. Some examples of
  2262.     using 64Dir are:
  2263.  
  2264.          64Dir $ df8:
  2265.  
  2266.         Will list the entire directory of drive 8.
  2267.  
  2268.          64Dir $:a* df9:
  2269.  
  2270.             Will list only the files that begin with "a" on drive 9.
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.                                                                         4-4
  2307.  
  2308.  
  2309.  
  2310. -
  2311.  
  2312.  
  2313.  
  2314. 64Print
  2315.  
  2316.     PURPOSE:     Print a file to C64 printer
  2317.  
  2318.     USAGE:       64Print <filename> <device> [option]
  2319.                      <filename> is the name of the file you wish to print.
  2320.                      <device> is a C64 printer number, either 4 or 5.  The
  2321.                          default is 4.
  2322.                      [option] can be either A for ASCII or B for Binary The
  2323.                          default is A.  The difference between these options
  2324.                          is that A will convert the file from ASCII to
  2325.                          PetASCII before printing it and B will not do any
  2326.                          conversion of the file.
  2327.  
  2328.     ENVIRONMENT: CLI
  2329.  
  2330.     INTERFACE:   YES
  2331.  
  2332.     64Print will allow you to print a file to a C64 printer.  Some examples of
  2333.     using 64Print are:
  2334.  
  2335.          64Print testfile
  2336.  
  2337.                  Will print the file "testfile"
  2338.  
  2339.          64Print testfile2 B
  2340.  
  2341.             Will print the file "testfile2" without any ASCII conversions.
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.                                                                         4-5
  2373.  
  2374.  
  2375.  
  2376. -
  2377.  
  2378.  
  2379.  
  2380. 64Status
  2381.  
  2382.     PURPOSE:     Read a the status of a C64 disk drive
  2383.  
  2384.     USAGE:       64Status [drive]
  2385.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2386.                          df11:.  df8: is the default.
  2387.  
  2388.     ENVIRONMENT: CLI
  2389.  
  2390.     INTERFACE:   YES
  2391.  
  2392.     64Status allows you to read the status of a C64 disk drive.  When a C64
  2393.     drive encounters an error it will flash its read light off and on.  You
  2394.     can use 64Status to find out what caused the error.  An example of 64Status
  2395.     is:
  2396.  
  2397.         64Status df8:
  2398.  
  2399.             Will read the status of drive 8.
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.                                                                         4-5
  2439.  
  2440.  
  2441.  
  2442. -
  2443.  
  2444.  
  2445.  
  2446. 64ToAmiga
  2447.  
  2448.     PURPOSE:     Copy a file from a C64 drive to an Amiga drive.
  2449.  
  2450.     USAGE:       64ToAmiga <source filename> <destination filename> [file type]
  2451.                      <source filename> is a C64 filename.
  2452.                      <destination filename> is an Amiga filename.
  2453.                      [file type] can be either P for PRG file or S for SEQ
  2454.                          file.  The default is P.
  2455.  
  2456.     ENVIRONMENT: CLI
  2457.  
  2458.     INTERFACE:   YES
  2459.  
  2460.         64ToAmiga will allow you to copy a file from a C64 disk drive to an
  2461.         Amiga disk drive.  Some examples of using 64ToAmiga are:
  2462.  
  2463.             64ToAmiga df8:testfile df0:
  2464.  
  2465.         Will copy the file "testfile" from the C64 drive 8 to the Amiga
  2466.                 drive 0.
  2467.  
  2468.             64ToAmiga df8:testfile2 df0:64Prgs/testfile S
  2469.  
  2470.                 Will copy the sequential file "testfile2" from the C64 drive 8
  2471.                 to the file "testfile" in the directory 64Prgs on Amiga drive
  2472.                 0.
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.                                                                         4-7
  2505.  
  2506.  
  2507.  
  2508. -
  2509.  
  2510.  
  2511.  
  2512. AmigaTo64
  2513.  
  2514.     PURPOSE:     Copy a file from an Amiga drive to a C64 drive.
  2515.  
  2516.     USAGE:       AmigaTo64 <source filename> <destination filename> [file type]
  2517.                      <source filename> is an Amiga filename.
  2518.                      <destination filename> is a C64 filename.
  2519.                      [file type] can be either P for PRG file or S for SEQ
  2520.                          file.  The default is P.
  2521.  
  2522.     ENVIRONMENT: CLI
  2523.  
  2524.     INTERFACE:   YES
  2525.  
  2526.         AmigaTo64 will allow you to copy a file from an Amiga disk drive to a
  2527.         C64 disk drive.  Some examples of using AmigaTo64 are:
  2528.  
  2529.             AmigaTo64 df0:testfile df8:
  2530.  
  2531.         Will copy the file "testfile" from the Amiga drive 0 to the C64
  2532.                 drive 8.
  2533.  
  2534.             AmigaTo64 df0:64Prgs/testfile df8:testfile2 S
  2535.  
  2536.                 Will copy the sequential file "testfile" from the directory
  2537.                 64Prgs on the Amiga drive 0 to the file "testfile2" on the C64
  2538.                 drive 8.
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.                                                                         4-8
  2571.  
  2572.  
  2573.  
  2574. -
  2575.  
  2576.  
  2577.  
  2578. InstallA64Font
  2579.  
  2580.     PURPOSE:     Install the A64 Font to FONTS:
  2581.  
  2582.     USAGE:       InstallA64Font
  2583.  
  2584.     ENVIRONMENT: WorkBench or CLI
  2585.  
  2586.     INTERFACE:   NO
  2587.  
  2588.     Install A64 Font will allow you to install the A64 font to the current
  2589.     FONTS: directory.  This font is needed by A64 and it must be installed on
  2590.     any WorkBench disk that you use with A64.
  2591.  
  2592.     To run InstallA64Font from the WorkBench follow this procedure:
  2593.  
  2594.         1. Double-click the InstallA64Font icon.
  2595.         2. A window will appear asking you to enter the name of the drive
  2596.            containing The A64 Package.  When this window appears enter the
  2597.            drive name and press RETURN.  For example, if the disk containing
  2598.            The A64 Package is in drive 0, enter: df0: [RETURN].
  2599.  
  2600.     The font will then be installed to the fonts directory on your WorkBench
  2601.     disk.
  2602.  
  2603.     See RUNNING A64 in the GETTING STARTED section for more information.
  2604.  
  2605.         
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.                                                                         4-9
  2637.  
  2638.  
  2639.  
  2640. -
  2641.  
  2642.  
  2643.  
  2644. Pet2ASCII
  2645.  
  2646.     PURPOSE:     Convert a file from PetASCII to ASCII.
  2647.  
  2648.     USAGE:       Pet2ASCII <source filename> [destination filename]
  2649.                      <source filename> is the name of the file you want to
  2650.                          convert
  2651.                      [destination filename] is the name of the file you want
  2652.                          to output the converted file to.  If not specified then
  2653.                          <source filename> will be overwritten by the converted
  2654.                          file.
  2655.  
  2656.     ENVIRONMENT: CLI
  2657.  
  2658.     INTERFACE:   NO
  2659.  
  2660.     Pet2ASCII will allow you to convert a file from PetASCII to standard ASCII.
  2661.     The C64 does not use standard ASCII.  "ASCII" stands for "American Standard
  2662.     Code for Information Interchange" and is a standardized method for the way
  2663.     that many computers represent certain information, namely english text. 
  2664.     This manual was written on an Amiga which uses ASCII codes to represent
  2665.     each letter and symbol.  The C64 has it's own form of ASCII called
  2666.     PetASCII.  The Commodore 64's PetASCII is quite a bit different from
  2667.     standard ASCII and for the Amiga to represent it correctly it must be
  2668.     converted to standard ASCII.
  2669.  
  2670.     Some examples of Pet2ASCII's usage are as follows:
  2671.  
  2672.         Pet2ASCII testfile
  2673.  
  2674.         Will covert the file "testfile" from PetASCII to ASCII.
  2675.  
  2676.         Pet2ASCII testfile testfile.asc
  2677.  
  2678.         Will covert the file "testfile" from PetASCII to ASCII, leaving
  2679.                 file "testfile" unchanged and the converted file in
  2680.                 "testfile.asc".
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.                                                                         4-10
  2703.  
  2704.  
  2705.  
  2706. -
  2707.  
  2708.  
  2709.  
  2710. PrintFile
  2711.  
  2712.     PURPOSE:     Print a file
  2713.  
  2714.     USAGE:       PrintFile [filename]
  2715.  
  2716.     ENVIRONMENT: WorkBench or CLI
  2717.  
  2718.     INTERFACE:   NO
  2719.  
  2720.     PrintFile will allow you to print a file to an Amiga printer.  It can be
  2721.     used from either the CLI or the WorkBench.  To use it from the WorkBench
  2722.     double-click its icon and then enter the name of the file you wish to
  2723.     print.  After entering the filename press the RETURN key to print the file.
  2724.     You can also pass PrintFile a filename by selecting a document icon and
  2725.     holding down one of the SHIFT keys while double-clicking the PrintFile
  2726.     icon.  For example if you want to print the file "ReadMe":
  2727.  
  2728.         1. Select the ReadMe icon by clicking the left mouse button on it once.
  2729.         2. Press one of the shift keys on the Amiga keyboard.
  2730.         3. Double-click the PrintFile icon while still holding down the shift
  2731.            key.
  2732.  
  2733.     PrintFile will then be started and automatically start printing the file
  2734.     "ReadMe."
  2735.  
  2736.     To run PrintFile from the CLI enter the following:
  2737.  
  2738.         PrintFile [filename]
  2739.  
  2740.     PrintFile will then be started and automatically start printing the file
  2741.     you specified.
  2742.  
  2743.     When PrintFile is done printing a file it does not close itself.  This
  2744.     allows you to print multiple files without restarting it.  To quit
  2745.     PrintFile select the close gadget at the top left hand corner of its window.
  2746.  
  2747.  
  2748.         
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.                                                                         4-11
  2769.  
  2770.  
  2771.  
  2772. -
  2773.  
  2774.  
  2775.  
  2776. StripLoadAddr
  2777.  
  2778.     PURPOSE:     Strip a C64 load address from a file
  2779.  
  2780.     USAGE:       StripLoadAddr <filename>
  2781.                      <filename> is the name of the file you want to strip the
  2782.                          load address from.
  2783.  
  2784.     ENVIRONMENT: CLI
  2785.  
  2786.     INTERFACE:   NO
  2787.  
  2788.     StripLoadAddr will allow you to strip a load address from a C64 file.  The
  2789.     C64 adds a two byte load address to the start of its PRG files that tells
  2790.     it where to load the file.  When transferring these files to the Amiga
  2791.     you may wish to strip this load address.  An example of using StripLoadAddr 
  2792.     is:
  2793.  
  2794.         StripLoadAddr testfile
  2795.  
  2796.         Will strip the load address from the file "testfile."
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.                                                                         4-12
  2835.  
  2836.  
  2837.  
  2838. -
  2839.  
  2840.  
  2841.  
  2842. C64 PROGRAMS
  2843.  
  2844.     The A64 Package comes with a couple of Commodore 64 programs, located in
  2845.     the directory 64Prgs.  These programs are as follows:
  2846.  
  2847.  
  2848. SaveROMs
  2849.  
  2850.     SaveROMs is for saving the C64 ROMs to disk.  It is meant to be run on a
  2851.     C64 because A64 does not contain the C64's ROMs.  To use this program
  2852.     see INSTALLING THE C64's ROMs in the TECHNICAL section.
  2853.  
  2854.  
  2855. 64Colors
  2856.  
  2857.     64Colors is a simple BASIC program that allows you to view the C64 colors.
  2858.     It was included with The A64 Package so you could experiment with A64's
  2859.     COLOR MODES while using it (See COLORS in the A64Prefs section).
  2860.  
  2861.     For information on how to load and run this program see DRIVES in the
  2862.     SYSTEM MENU section.
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.                                                                         4-13
  2901.  
  2902.  
  2903.  
  2904. -
  2905.  
  2906.  
  2907.  
  2908. TECHNICAL
  2909.  
  2910.  
  2911.  
  2912. THE A64 PACKAGES FILE STRUCTURE
  2913.  
  2914.     The A64 Package is very large and fills over 70% of 3.5" floppy disk,
  2915.     because of this, the entire package will not fit on a WorkBench disk.  Some
  2916.     users may wish to fit parts of The A64 PAckage onto a WorkBench disk,
  2917.     especially if they only have one disk drive.  This can be done by
  2918.     separating A64 from the rest of The A64 Package.  Please note that if you
  2919.     do separate The A64 Package into different parts you may not distribute
  2920.     them.  The A64 Package may only be distributed in its entirety.
  2921.  
  2922.     We are not going to discuss the exact details of how to extract parts of
  2923.     The A64 Package, but what we will do is tell you what directories and files
  2924.     are needed to run just A64.  Listed below is a directory listing of The
  2925.     A64 Package.  Directories and Files that appear with an "*" before their
  2926.     name must appear as listed for A64 to run.  All other files may be moved
  2927.     or removed.  Please note that the "*" is not part of the name of the
  2928.     directories and files and appears only to show what should stay as listed.
  2929.     Please note that if you want to have the ability to install the A64 Font
  2930.     onto a WorkBench disk you will need the files marked with "#".  Again, this
  2931.     symbol is not part of the names, but is used to signify them.
  2932.  
  2933.     *TheA64Package
  2934.          A64Utilities (dir)
  2935.            !.info                           .info
  2936.            64Cmd                            64Dir
  2937.            64Print                          64Status
  2938.            64ToAmiga                        AmigaTo64
  2939.            Pet2ASCII                        StripLoadAddr
  2940.          64Prgs (dir)
  2941.            64Colors                         SaveROMs
  2942.         #Fonts (dir)
  2943.              #A64 (dir)
  2944.                #6                                
  2945.           #A64.font                         
  2946.         *64Fonts (dir)
  2947.           *CharROM.64font                   
  2948.       .info                           *A64
  2949.      *A64.config                      *A64.info
  2950.       A64Utilities.info               *BASIC.data
  2951.       InitA64                         #InstallA64Font
  2952.      #InstallA64Font.info             *KERNAL.data
  2953.      *Lic                              Manual
  2954.       Manual.info                      PrintFile
  2955.       PrintFile.info                   ReadMe
  2956.       ReadMe.info                      Registration.form
  2957.       Registration.form.info          *ROM
  2958.      *Title                            
  2959.     *TheA64Package.info
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.                                                                         5-1
  2967.  
  2968.  
  2969.  
  2970. -
  2971.  
  2972.  
  2973.  
  2974. THE KEYBOARD
  2975.  
  2976.  
  2977. KEYBOARD DIFFERENCES
  2978.  
  2979.     There are some minor differences between the C64 keyboard and the Amiga's.
  2980.     The way A64 maps the keyboard is pretty much "what you see is what you
  2981.     get."  In most cases the legends on the keys represent their equivalent
  2982.     function.
  2983.  
  2984.     The exceptions to this are:
  2985.  
  2986.         AMIGA KEY            C64 EQUIVALENT
  2987.         ---------            --------------
  2988.         ESC                RUN/STOP
  2989.         BACKSPACE (BACKARROW)        CLR/HOME
  2990.         HELP                RESTORE
  2991.         LEFT AMIGA            COMMODORE
  2992.         `~                BACK ARROW
  2993.         \|                LYRA
  2994.         [{                [ (when shifted gives PI)
  2995.         ]}                ] (when shifted gives shift @)
  2996.  
  2997.     NOTE: The key sequence [RUN/STOP] [RESTORE] that is used to stop C64 BASIC
  2998.           programs, can be done by pressing [ESC] [HELP].
  2999.  
  3000. A PROBLEM WITH THE KEYBOARD
  3001.  
  3002.     Because of differences in a small number of keys on the keyboards of the
  3003.     C64 and the Amiga, a minor problem can occur with certain key sequences.
  3004.     This problem is rare and under normal typing situations should not be
  3005.     apparent.  It is related to pressing one or more of the shift keys and
  3006.     one of the numeric or punctuation keys simultaneously.  What will happen
  3007.     is that A64 will think you pressed a key that you didn't and an unwanted
  3008.     character will appear on the screen.  If this happens use the DEL key to
  3009.     delete the unwanted character.  Please note that this is not a "BUG" in
  3010.     A64, but is related to the way that the C64 reads the keyboard.
  3011.  
  3012. THE NUMERIC KEYPAD
  3013.  
  3014.     The numeric keypad on the Amiga keyboard is fully supported.  It should be
  3015.     noted that shifting the keys on the keypad will give the C64 equivalent and
  3016.     not the Amiga's equivalent.
  3017.  
  3018.     For example, using the key sequence: [SHIFT] [2]
  3019.  
  3020.     On the Amiga: [SHIFT] [2] (2 key at top left of keyboard) produces the '@'
  3021.                   [SHIFT] [2] (2 key on the numeric keypad) produces the '"'
  3022.  
  3023.     On the C64:   [SHIFT] [2] produces the '"'
  3024.  
  3025.     NOTE: By using the numeric keypad and it's C64 shifted equivalents you will
  3026.           eliminate most of the keys that can cause the problem listed above. 
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.                                                                         5-2
  3033.  
  3034.  
  3035.  
  3036. -
  3037.  
  3038.  
  3039.  
  3040. UNUSED KEYS
  3041.  
  3042.     There are a few of keys on the Amiga keyboard that are unused by A64.  They
  3043.     are as follows: TAB, F9, F10 and RIGHT AMIGA.  Also, when pressed
  3044.     simultaneously the two ALT keys will invoke A64 Prefs, but have no meaning
  3045.     when pressed by themselves.
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.                                                                         5-3
  3099.  
  3100.  
  3101.  
  3102. -
  3103.  
  3104.  
  3105.  
  3106. A64 AND MULTITASKING
  3107.  
  3108.     A64 is the first true multitasking Commodore 64 emulator.  A64's
  3109.     multitasking ability gives it power and flexibility and allows it to be a
  3110.     stable and reliable program (Multitasking programs are MUCH easier to debug
  3111.     and improve than programs that take over your Amiga).  We hope you'll agree
  3112.     with us when we say "it's A64's multitasking ability that sets it apart
  3113.     from the other C64 emulators."
  3114.  
  3115.     Until now, everyone thought a program like a C64 emulator had to take over
  3116.     your Amiga, because it needs to run as fast as possible and needs system
  3117.     resources that the Amiga's operating system usually uses.  A64 manages to
  3118.     run faster than the other C64 emulators, use all the Amiga resources it
  3119.     needs and still leave the Amiga's operating system intact.  We can not even
  3120.     begin to explain what went into getting A64 to accomplish this amazing
  3121.     feat.  What we can say is that A64 should work just fine with any program
  3122.     that follows the rules of multitasking programming on the Amiga.  There have
  3123.     been times that we forgot that we were running A64 because we exited back
  3124.     to the WorkBench or the CLI to do something else and then after hours of
  3125.     running other programs we remembered that A64 was still in memory and we
  3126.     went back to it and found it working perfectly.  The only programs that A64
  3127.     may not work with are programs that take over, some part of or all of, your
  3128.     Amiga, like some games and other emulators.  Which brings up to our next
  3129.     point.  A64 can not multitask itself.  Even though A64 is capable of
  3130.     multitasking it still takes over system resources that can not be shared
  3131.     with other programs, so one copy of A64 can not share these resources with
  3132.     another copy of A64.
  3133.  
  3134.  
  3135. A64 AND MEMORY
  3136.  
  3137.     A64 is a very memory hungry program and in its full capacity it will take
  3138.     up over 300k of your Amiga's memory.  If your Amiga has less than 1mb of
  3139.     RAM, more likely than not, A64 will not run.  There are some things that
  3140.     users with 512k can do to get A64 to work.  If they install the C64's ROMs
  3141.     (See INSTALLING THE C64's ROMs in the TECHNICAL section) they can save
  3142.     about 135k of RAM, but doing this will greatly decrease A64's speed. 
  3143.     Please note that it is not the installation of the C64's ROMs that slows
  3144.     down A64, but rather the fact that 512k users do not have enough RAM to use
  3145.     A64's ROM emulation, which runs dramatically faster than the C64's ROMs
  3146.     by themselves.  Users with 1mb or more can install the C64's ROMs with no
  3147.     decrease in speed, just added compatibility.  Other things can also be done
  3148.     to save memory, like: make sure there are no other programs running, don't
  3149.     load the WorkBench and remove all external drives.  None of these options
  3150.     are really desireable and for that reason we recommend at least 1mb of RAM
  3151.     when using A64.
  3152.  
  3153.     Different memory configurations can make a dramatic difference in the speed
  3154.     of A64.  The worst case is running A64 on a 512k RAM system and the best
  3155.     case is running A64 on a 68020 based system with 32 bit RAM.  On a 68020
  3156.     based system speeds of well over 100% can be reached (We have not yet been
  3157.     able to try A64 on a 68030 based system, but we estimate speeds of around
  3158.     200% for some programs.  See 680x0 SUPPORT in the TECHNICAL section).  We
  3159.     normally recommend at least 1mb of RAM no matter how your Amiga is
  3160.     configured and this statement can be elaborated.  If you are running A64
  3161.     on an Amiga 1000 we recommend at least 1mb of RAM.  If you are running A64
  3162.     on an A500 or A2000 we recommend at least 1.5mb.  The reason for this
  3163.  
  3164.                                                                         5-4
  3165.  
  3166.  
  3167.  
  3168. -
  3169.  
  3170.  
  3171.  
  3172.     difference is not because A64 will not run on A500s or A2000s with only
  3173.     1mb, it's because A64 will run faster if these machines have more than 1mb.
  3174.     This is because A500's and A2000's with only 1mb don't have what is called
  3175.     FAST RAM.  This is RAM that can not be used by graphics and as a result
  3176.     programs run faster when using it.  We also recommend running the program
  3177.     "FastMemFirst," found in the System drawer of the V1.3 WorkBench, before
  3178.     running A64.  This program will force A64 (and other programs) to use this
  3179.     FASTer memory first.
  3180.  
  3181.  
  3182. 680x0 SUPPORT
  3183.  
  3184.     Basically most of the programs in this release of The A64 Package were
  3185.     designed to work with the 68000 microprocessor only.  The utility programs
  3186.     that use A64's hardware interface can be made to work with any
  3187.     microprocessor as long as if a 68020 is used its cache is turned off.  All
  3188.     other utilities will work with any microprocessor.  A64 itself can NOT be
  3189.     made to run with other microprocessors.  It does a check of the installed
  3190.     microprocessor and will not run if the wrong one is installed.  We
  3191.     currently have a separate version of A64 that runs with 68010 and 68020
  3192.     microprocessors and it is VERY impressive.  We are working on having just
  3193.     one version of A64 that will work with ALL the 680x0 microprocessors. When
  3194.     we have completed making all programs in The A64 Package 680x0 compatible
  3195.     we will release them as an update.
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.                                                                         5-5
  3231.  
  3232.  
  3233.  
  3234. -
  3235.  
  3236.  
  3237.  
  3238. ROMS
  3239.  
  3240. WHAT IS ROM
  3241.  
  3242.     ROM is short for "READ ONLY MEMORY."  A ROM is a computer chip that is
  3243.     capable of storing a program and like its name implies, it is READ ONLY,
  3244.     which means you can not change the program it contains.  ROM unlike RAM
  3245.     (your computer's memory) does not loose its contents when your computer is
  3246.     turned off.  Computers usually come with ROM to tell it what to do when
  3247.     it's turned on.  Your Amiga uses a ROM called "KickStart."
  3248.  
  3249. THE C64's ROMS
  3250.  
  3251.     The C64 has two ROMs that contain its operating system.  One ROM holds the 
  3252.     C64's BASIC and the other ROM holds the C64's KERNAL.  A64 does not come
  3253.     with the C64's BASIC or KERNAL, because they are copyrighted.  Before you
  3254.     start worrying that A64 will not work without them, this is NOT the case.
  3255.     A64 contains a very complex C64 ROM emulation which allows A64 to run most
  3256.     C64 programs, without the C64's ROMs.
  3257.  
  3258. A64'S ROMS
  3259.  
  3260.     NOTE: This section of the manual gets a little technical by discussing
  3261.           machine language.  If you are not familiar with machine language you
  3262.           should still read this section and and try to follow it as best you
  3263.           can, it contains some important information about A64.
  3264.  
  3265.     As mentioned above, A64 comes with a very complex C64 ROM emulation, this
  3266.     ROM emulation will handle the majority of C64 programs, but not all of
  3267.     them.  To explain what A64's ROM emulation will and will not handle we need
  3268.     to discuss machine language.
  3269.  
  3270.     The C64's ROMs contain machine language programs.  Machine language
  3271.     programs are made up of opcodes.  Opcodes are machine language instructions
  3272.     that tell the computer to perform some tiny operation, like move a value
  3273.     from one place to another or perform some kind of operation to a value.  It
  3274.     takes many, many opcodes to perform even the simplest operations on your
  3275.     computer.  The C64's ROMs contain many thousands of these opcodes.  The
  3276.     C64's ROMs are located in the C64's memory map at 40960-49151 (BASIC) and
  3277.     57344-65535 (KERNAL), these numbers are called addresses.  To access the
  3278.     C64's ROMs and the opcodes they contain you need to JUMP to one of these
  3279.     addresses.  With BASIC this done with the command "SYS."
  3280.  
  3281.     For example, to reset the C64 (or A64), you can type the following:
  3282.  
  3283.        SYS 64738 [RETURN]
  3284.  
  3285.     This will cause the C64 (or A64) to enter the KERNAL ROM at address 64738
  3286.     and start executing machine language opcodes starting at that address.
  3287.  
  3288.     If you were to disassemble (a disassembler is a program that turns machine 
  3289.     language into a readable form) one of the C64's ROMs, you would get a
  3290.     listing similar to this:
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.                                                                         5-6
  3297.  
  3298.  
  3299.  
  3300. -
  3301.  
  3302.  
  3303.  
  3304.         40960   LDX #10
  3305.         40962    LDA #138
  3306.         40964    STA 1024
  3307.         40967    ...
  3308.  
  3309.     NOTE: This listing is only used as an example and is not part of the C64's
  3310.           ROMs.
  3311.  
  3312.     The listing shows ROM addresses followed by the opcode stored at each
  3313.     address.  Please note that the addresses are not perfectly consecutive,
  3314.     this is because different opcodes have different lengths.  If A64 was to
  3315.     JUMP into the ROMs, using the above example, it would handle JUMPING in at
  3316.     all of the shown addresses: 40960, 40962, 40964 and 40967.  The problem
  3317.     occurs if A64 tried to JUMP in at one of the addresses not shown, the
  3318.     addresses between opcodes.  Because of the way machine language is, it is
  3319.     possible for an opcode to have another opcode contained within it.  For
  3320.     example, if you disassembled the same code as above, but started at address
  3321.     40963, you would get a listing like this:
  3322.  
  3323.         40963    TXA
  3324.         40964    STA 1024
  3325.         40967    ...
  3326.  
  3327.     The opcode "TXA" at address 40963 is contained within the opcode "LDA #138"
  3328.     at address 40962.  This is what A64 will not handle, when emulating the
  3329.     C64's ROMs, the JUMPING into the ROMs between opcodes.  If you are running
  3330.     a program that tries to JUMP into the C64's ROMs between opcodes A64 will
  3331.     trap it and display an error requester telling you "PROGRAM TRYING TO
  3332.     EXECUTE BETWEEN OPCODES."  This problem is only apparent when JUMPING into
  3333.     the C64's ROMs between opcodes and is not a problem when running C64
  3334.     programs that use the same technique to JUMP within themselves.  This
  3335.     problem can be corrected by installing the C64's ROMs into A64.
  3336.  
  3337. INSTALLING THE C64 ROMS
  3338.  
  3339.     Installing the C64's ROMs into A64, basically involves saving the contents
  3340.     of the C64's ROMs (this must be done on a C64) to a C64 disk and then
  3341.     copying them to your A64 disk.  Installing the C64's ROMs into A64 is not
  3342.     difficult, but it does require a few small steps to accomplish.  Once the
  3343.     C64's ROMs are installed you never have to worry about them again.  A64
  3344.     will automatically load the C64's ROMs and use them whenever the above
  3345.     mentioned problem occurs.
  3346.  
  3347.     To install the C64 ROMs you need the following:
  3348.  
  3349.     A C64
  3350.     A C64 disk drive (i.e., 1541)
  3351.     A64's hardware interface
  3352.     A 5 1/4" disk, formatted on a C64, with at least 20k free
  3353.             (NOTE: You can format the C64 disk with the utility 64Cmd).
  3354.  
  3355.     and the following programs that are included with The A64 Package:
  3356.  
  3357.         SaveROMs
  3358.     AmigaTo64
  3359.     64ToAmiga
  3360.     StripLoadAddr
  3361.  
  3362.                                                                         5-7
  3363.  
  3364.  
  3365.  
  3366. -
  3367.  
  3368.  
  3369.  
  3370.     The following procedure outlines the installation of the C64 ROMs. Part of
  3371.     it has to be done on a C64 and the rest must be done from the CLI on an
  3372.     Amiga.  Your current directory from the CLI should be TheA64Package.
  3373.     For example, with the disk containing The A64 Package in drive 1, you
  3374.     should type:
  3375.  
  3376.         cd df1:TheA64Package
  3377.  
  3378.     The first thing you need to do is copy the C64 program "SaveROMs" from
  3379.     The A64 Package to a C64 disk.  This program is used to save the Commodore
  3380.     64's ROMs to a C64 disk.
  3381.  
  3382.         1. Install A64's hardware interface and connect a C64 disk drive to it
  3383.            (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  3384.            section).
  3385.         2. With a C64 disk in the C64 drive, use the utility "AmigaTo64" to
  3386.            transfer the program "SaveROMs to the C64 disk.  To do this type the
  3387.            following from the CLI:
  3388.  
  3389.             A64Utilities/AmigaTo64 64Prgs/saveroms df8: [RETURN]
  3390.  
  3391.             (Note "saveroms" is in all lowercase letters)
  3392.  
  3393.     Now that the C64 program "SaveROMs" is on the C64 disk you need to load and
  3394.     run it on a C64:
  3395.  
  3396.         1. Either unplug the C64 disk drive from the interface or use another
  3397.            C64 disk drive and connect it to a C64.
  3398.         2. With the C64 disk containing the program "SaveROMs" in the C64 disk
  3399.            drive type the following on the C64:
  3400.  
  3401.             LOAD "SAVEROMS",8 [RETURN] 
  3402.  
  3403.         3. After the program is done loading type:
  3404.  
  3405.             RUN [RETURN]
  3406.  
  3407.         4. You will then be prompted to insert a disk into drive 8 and press
  3408.            any key when ready.
  3409.         5. After pressing any key the C64 ROMs will be saved to the C64 disk.
  3410.  
  3411.     Now that the C64's ROMs are saved to a C64 disk you need to transfer them
  3412.     to your disk containing The A64 Package.
  3413.  
  3414.         1. If you need to reconnect the C64 disk drive to your Amiga with A64's
  3415.            hardware interface, do so.
  3416.         2. With the program "64ToAmiga" transfer the files BASIC.rom and
  3417.            KERNAL.rom from the C64 disk to your disk containing The A64
  3418.            Package.  To do this type the following from the CLI:
  3419.  
  3420.             A64Utilities/64ToAmiga basic.rom BASIC.rom [RETURN]
  3421.  
  3422.             and then:
  3423.  
  3424.             A64Utilities/64ToAmiga kernal.rom KERNAL.rom [RETURN]
  3425.  
  3426.  
  3427.  
  3428.                                                                         5-8
  3429.  
  3430.  
  3431.  
  3432. -
  3433.  
  3434.  
  3435.  
  3436.         3. After the C64's ROMs are installed onto The A64 Package disk you
  3437.            must run "StripLoadAddr" on them before A64 can use them. To do this
  3438.            type the following from the CLI:
  3439.  
  3440.             A64Utilities/StripLoadAddr BASIC.rom [RETURN]
  3441.  
  3442.             and then:
  3443.  
  3444.             A64Utilities/StripLoadAddr KERNAL.rom [RETURN]
  3445.  
  3446.     The C64's ROMs are now installed.  A64 will automatically load and use them
  3447.     when needed.
  3448.  
  3449.     NOTE: If you are running A64 with 512k RAM, installing the C64's ROMs will
  3450.           replace A64's ROM emulation and save you about 135k of RAM, but will
  3451.           result in A64 running slower.  Because A64's ROM emulation operates
  3452.           much faster than the C64 ROMs do, A64 will try to use its ROM
  3453.           emulation whenever possible and if you are running A64 with 1mb or
  3454.           more, the C64's ROMs will only be used as a fail-safe when the above
  3455.           mentioned problem occurs.
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.                                                                         5-9
  3495.  
  3496.  
  3497.  
  3498. -
  3499.  
  3500.  
  3501.  
  3502. PROBLEMS AND SOLUTIONS
  3503.  
  3504.     I can't get programs in The A64 Package to recognize a C64 disk drive.
  3505.  
  3506.         First of all make sure the hardware interface is installed correctly
  3507.         (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  3508.         section).  If you think the interface is installed correctly then try
  3509.         turning the disk drive of and then on again, this will reset the disk
  3510.         drive.  The C64 disk drives may need to be reset from time to time when
  3511.         running A64.  If you are running a C64 program that used copy
  3512.         protection you may have to reset the drive to clear it.
  3513.  
  3514.     When trying to load a C64 program the C64 disk drive light comes on but the
  3515.     program doesn't load and A64 appears to have locked up.
  3516.  
  3517.         The program you are trying to load may be using a technique called
  3518.         "FAST LOADING."  FAST LOADING is a technique used to to speed up
  3519.         communications with a C64 disk drive.  A64 can not handle FAST LOADING
  3520.         (See INCOMPATIBILITIES in the PROBLEMS and SOLUTIONS section).  If this
  3521.         situation occurs you will have to reset the C64 drive and then reset
  3522.         A64.
  3523.  
  3524.     I think my hardware interface is faulty.
  3525.  
  3526.         We have a VERY low failure rate with our hardware interfaces.  Usually
  3527.         when a problem occurs it is because of something not being done
  3528.         correctly or by trying to do something that A64 will not handle. If you
  3529.         think you're interface is bad you can run the program "64Status" to
  3530.         test it (See 64Status in the UTILITIES section).  If this program works
  3531.         as its supposed to then your interface is not faulty and the problem
  3532.         lies somewhere else.  Please note that if the 64Status program doesn't
  3533.         work it is still possible that the interface is still not faulty.  We
  3534.         know of a couple of people who have "blown" their parallel port by
  3535.         plugging in the interface or some other piece of hardware with their
  3536.         Amiga turned on.  Before concluding that the interface is faulty you
  3537.         should try using some other piece of hardware on your Amiga's parallel
  3538.         port like a parallel printer or digitizer.  If they work, and the
  3539.         interface doesn't, then you probably do have a faulty interface.  You
  3540.         could also try to test the interface on someone elses Amiga.  If you
  3541.         do have a faulty interface we will replace it (See REPLACEMENTS on page
  3542.         2).
  3543.  
  3544.     When moving the mouse strange characters appear on the screen and the
  3545.     keyboard doesn't work.
  3546.  
  3547.         See GAME PORTS in the SYSTEM MENU section.
  3548.  
  3549.     For more information on other possible problems see A64 PREFS NOTES in the
  3550.     A64 PREFS section.
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.                                                                         6-1
  3561.  
  3562.  
  3563.  
  3564. -
  3565.  
  3566.  
  3567.  
  3568. A64 ERRORS
  3569.  
  3570.     A64 has quite an extensive error handling system.  A64 does its best to
  3571.     tell you when it can't do something by displaying a requester.  These
  3572.     requesters are called error requesters and they display an error in three
  3573.     ways:
  3574.  
  3575.         1. At the top of the requester will be the type of error, either FATAL
  3576.            or NON-FATAL.  The meaning of each is as follows:
  3577.  
  3578.             FATAL ERRORs are just as the name implies, FATAL to A64.  If you
  3579.             get a fatal error this means that A64 has encountered some
  3580.             situation that will forbid it to continue and it will have to exit
  3581.             back to WorkBench.  After you handle the requester, by selecting
  3582.             one of its gadgets, a fatal error will force A64 to remove itself
  3583.             from memory and return you to the WorkBench.  Fatal errors usually
  3584.             occur only during the loading and initialization of A64.
  3585.  
  3586.             NON-FATAL ERRORs are a little more forgiving than FATAL errors.
  3587.             They signify that A64 has encountered some situation that it can
  3588.             not currently handle, but which is not serious enough to cause A64
  3589.             to exit back to the WorkBench.  After you handle the requester, by
  3590.             selecting one of its  gadgets, A64 will automatically leave you in
  3591.             A64 Prefs to try to correct the situation that caused the error.
  3592.             After being put into A64 Prefs your choice of action depends on
  3593.             what caused the error.  If you are unable to correct the situation
  3594.             that caused the error then you should reset A64 (See RESET A64 in
  3595.             the PROJECT MENU section).
  3596.  
  3597.         2. Following the type of error will be an eight digit error number.
  3598.            This error number is an error code that represents the exact cause
  3599.            and location of the error.
  3600.  
  3601.         3. In the middle of the requester will be one or two lines of text
  3602.            giving a short description of the error.
  3603.  
  3604.     At the bottom of the error requester are two gadgets, labeled CONTINUE and
  3605.     DEBUG.  Their functions are:
  3606.  
  3607.     CONTINUE will cause A64 to remove the requester.  You will then either
  3608.         be returned to WorkBench or put into A64 Prefs depending on the type of
  3609.         error (FATAL or NON-FATAL) discussed above.
  3610.  
  3611.     DEBUG will cause A64 to put up an Alert showing the internal state of
  3612.         A64 when the error occurred.  This information will probably not mean
  3613.         anything to you, but it can be invaluable to us for tracking down
  3614.         errors.  After viewing the information in the Alert press a mouse
  3615.         button to remove the Alert.  You will then either be returned to
  3616.         the WorkBench or put into A64 Prefs depending on the type of error
  3617.         (FATAL or NON-FATAL) discussed above.
  3618.  
  3619.         NOTE: In the appendices of this manual is an ERROR REPORT.  If you are
  3620.               experiencing problems with a particular C64 program, or if you
  3621.               encounter an error that is not in the error list, you can send us
  3622.               a copy of the ERROR REPORT containing the information displayed
  3623.               in the Alert.  We will try to correct as many errors as possible
  3624.               for future releases.    
  3625.  
  3626.                                                                         6-2
  3627.  
  3628.  
  3629.  
  3630. -
  3631.  
  3632.  
  3633.  
  3634. ERROR LIST
  3635.  
  3636.     The following list contains A64's possible errors.  The errors are shown by
  3637.     the error number followed by a line stating the error, which should be the
  3638.     same text that appears in the error requester.  Below the line stating the
  3639.     error is a short comment on what caused the error, how to correct it and
  3640.     what section of the manual to check for more information.
  3641.  
  3642.     Errors that state "Should NEVER happen" should never occur, but if they do
  3643.     the probable cause is that something has corrupted your Amiga's memory or
  3644.     that you are out of memory.
  3645.  
  3646.     The appearance of a "x" in an error number means, that digit of the error
  3647.     number will contain some unpredetermined value.  There may be a comment
  3648.     stating what the digit will be.
  3649.  
  3650.     Error numbers that start with 8 are FATAL errors.  All other errors are
  3651.     NON-FATAL.
  3652.  
  3653.     Multiple error numbers mean that the error can be generated in more than
  3654.     one place in A64.
  3655.  
  3656.  
  3657. $80000001    COULD NOT OPEN: DOS LIBRARY
  3658.         Should NEVER happen.
  3659.  
  3660. $80000002    COULD NOT OPEN: GRAPHICS LIBRARY
  3661.         Should NEVER happen.
  3662.  
  3663. $80000003    COULD NOT OPEN: DISKFONT LIBRARY
  3664.         Make sure the file diskfont.lib is in your WorkBench's Libs
  3665.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  3666.         section).
  3667.  
  3668. $80000004    COULD NOT OPEN: CIA A RESOURCE
  3669.         Should NEVER happen.
  3670.  
  3671. $80000005    COULD NOT OPEN: CIA B RESOURCE
  3672.         Should NEVER happen.
  3673.  
  3674. $80000006    COULD NOT OPEN: MISC RESOURCE
  3675.         Should NEVER happen.
  3676.  
  3677. $80000007    OUT OF MEMORY, COULD NOT ALLOCATE: C64 MEMORY MAP
  3678.         You do not have enough RAM available to run A64 (See A64 AND
  3679.         MEMORY in the TECHNICAL section).
  3680.  
  3681. $8f000108    COULD NOT OPEN OR READ: BASIC.DATA
  3682. $8f000208    Make sure the file BASIC.data is in the TheA64Package
  3683.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  3684.         section).
  3685.  
  3686. $8f000109    COULD NOT OPEN OR READ: KERNAL.DATA
  3687. $8f000209    Make sure the file KERNAL.data is in the TheA64Package
  3688.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  3689.         section).
  3690.  
  3691.  
  3692.                                                                         6-3
  3693.  
  3694.  
  3695.  
  3696. -
  3697.  
  3698.  
  3699.  
  3700. $8f00010a    COULD NOT OPEN OR READ: CHARROM.64FONT
  3701. $8f00020a     Make sure the file CharROM.64Font is in the 64Fonts directory
  3702.         (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3703.  
  3704. $8000000b    OUT OF MEMORY, COULD NOT ALLOCATE: A64 ROM BUFFER
  3705.         You do not have enough RAM available to run A64 (See A64 AND
  3706.         MEMORY in the TECHNICAL section).  You may be able to correct
  3707.                 this error by installing the C64's ROMs (See INSTALLING THE
  3708.         C64's ROMs in the ROMs section).
  3709.  
  3710. $8f00010c    COULD NOT OPEN OR READ: ROM
  3711. $8f00020c    Make sure the file ROM is in the TheA64Package directory (See
  3712.         THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3713.  
  3714. $8000000d    COULD NOT: INSTALL A64 ROMs
  3715.         This error should never occur, if it does something has
  3716.         probably corrupted the Amiga's memory.
  3717.  
  3718. $8000000e    A64 WILL NOT RUN WITH INSTALLED MICROPROCESSOR
  3719.         You are trying to run the wrong version of A64 for your Amiga
  3720.         (See 680x0 SUPPORT in the TECHNICAL section).
  3721.  
  3722. $8000000f    YOU CAN NOT RUN TWO COPIES OF A64 SIMULTANEOUSLY
  3723.         A64 can not multitask itself (See A64 AND MULTITASKING in the
  3724.         TECHNICAL section).        
  3725.  
  3726. $80010000    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 1
  3727.         You do not have enough RAM available to run A64 (See A64 AND
  3728.         MEMORY in the TECHNICAL section).
  3729.  
  3730. $80010001    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 2
  3731.         You do not have enough RAM available to run A64 (See A64 AND
  3732.         MEMORY in the TECHNICAL section).
  3733.  
  3734. $80010002    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 3
  3735.         You do not have enough RAM available to run A64 (See A64 AND
  3736.         MEMORY in the TECHNICAL section).
  3737.  
  3738. $8f010x03    COULD NOT OPEN OR READ: TITLE
  3739. $8f010x04    Make sure the file Title is in the TheA64Package directory (See
  3740. $8f010x05    THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3741. $8f010x06    The "x" in the error number will be either 1 or 2.
  3742.  
  3743. $80010007    COULD NOT OPEN: TITLE SCREEN
  3744.         If this error occurs you are probably out of memory (See A64
  3745.         AND MEMORY in the TECHNICAL section).
  3746.  
  3747. $80010008    COULD NOT OPEN: TITLE WINDOW
  3748.         If this error occurs you are probably out of memory (See A64
  3749.         AND MEMORY in the TECHNICAL section).
  3750.  
  3751. $80010009    COULD NOT OPEN: A64 SCREEN
  3752.         If this error occurs you are probably out of memory (See A64
  3753.         AND MEMORY in the TECHNICAL section).
  3754.  
  3755.  
  3756.  
  3757.  
  3758.                                                                         6-4
  3759.  
  3760.  
  3761.  
  3762. -
  3763.  
  3764.  
  3765.  
  3766. $8001000a    COULD NOT OPEN: A64 WINDOW
  3767.         If this error occurs you are probably out of memory (See A64
  3768.         AND MEMORY in the TECHNICAL section).
  3769.  
  3770. $8001000b    COULD NOT OPEN: A64 6 FONT
  3771.         Make sure you have installed the font with InstallA64Font (See
  3772.         RUNNING A64 in the GETTING started section and InstallA64Font
  3773.         in the UTILITIES section).  If you still get this error after
  3774.         installing the font you are probably out of memory (See A64 AND
  3775.         MEMORY in the TECHNICAL section).
  3776.  
  3777. $8001000c    COULD NOT OPEN: TOPAZ 8 FONT
  3778.         Should NEVER happen.
  3779.  
  3780. $8f01010d    COULD NOT OPEN OR READ: LIC
  3781. $8f01020d    Make sure the file Lic is in the TheA64Package directory (See
  3782.         THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3783.  
  3784. $00020000    COULD NOT OPEN: REQUESTER
  3785.         If this error occurs you are probably out of memory (See A64
  3786.         AND MEMORY in the TECHNICAL section).
  3787.  
  3788. $00020001    COULD NOT: LOCK A64 PREFS SCREEN
  3789.         This error should never occur, if it does something has
  3790.         probably corrupted the Amiga's memory.
  3791.  
  3792. $0f020102    COULD NOT OPEN OR READ: CONFIG FILE
  3793. $0f020202    The configuration file your trying to load can not be loaded.
  3794.         Check the spelling of the filename (See LOAD CONFIG in the
  3795.         PROJECT MENU section).  If this error occurs when A64 is
  3796.         loading then it can not read the file A64.config and you
  3797.         should make sure this file is in the TheA64Package directory
  3798.         (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3799.  
  3800. $0f020103    COULD NOT OPEN OR WRITE: CONFIG FILE
  3801. $0f020303    For some reason A64 can not create the configuration file you
  3802.         requested.  Make sure you've specified the correct drive and
  3803.         that the disk is write enabled. (See SAVE CONFIG in the PROJECT
  3804.         MENU section)
  3805.  
  3806. $00030000    COULD NOT TAKE: PARALLEL PORT
  3807.         Some program has exclusive use of the Amiga's parallel port.
  3808.         You must make the program release the parallel port before A64
  3809.         can use it (See PAR PORT in the SYSTEM MENU section).
  3810.  
  3811. $00040000    A64 DOES NOT OWN THE PARALLEL PORT
  3812.         You are trying to access the parallel port when A64 does not
  3813.         own it.  Select A64 in PAR PORT menu option (See PAR PORT in
  3814.         the SYSTEM MENU section).
  3815.  
  3816. $00040001    ERROR TRYING TO WRITE TO AN AMIGA DEVICE
  3817. $00040002    Some problem has occurred when trying to write a file to an
  3818. $00040003    Amiga drive.  Make sure you've specified the correct drive and
  3819.         that the disk is write enabled. (See DRIVES and AMIGA DRIVES
  3820.         in the SYSTEM MENU section).
  3821.  
  3822.  
  3823.  
  3824.                                                                         6-5
  3825.  
  3826.  
  3827.  
  3828. -
  3829.  
  3830.  
  3831.         
  3832. $00040004    ILLEGAL ACCESS TO AMIGA DEVICE CAN NOT USE COMMAND CHANNEL 15
  3833.         The C64 program you are running is trying to access a disk
  3834.         drive in a way that an Amiga drive can not handle (See AMIGA
  3835.         DRIVES in the SYSTEM MENU section).
  3836.  
  3837. $00040005    ERROR TRYING TO SAVE TO AN AMIGA DEVICE
  3838. $00040006    Some problem has occurred when trying to save a file to an
  3839. $00040007    Amiga drive.  Make sure you've specified the correct drive and
  3840.         that the disk is write enabled. (See DRIVES and AMIGA DRIVES
  3841.         in the SYSTEM MENU section).
  3842.  
  3843. $00040008    ERROR TRYING TO LOAD FROM AN AMIGA DEVICE
  3844. $00040009    Some problem has occurred when trying to load a file from an
  3845. $0004000a    Amiga drive.  Check the spelling of the filename and the DRIVES
  3846.         settings (See DRIVES and AMIGA DRIVES in the SYSTEM MENU
  3847.         section).
  3848.  
  3849. $0004000b    ERROR TRYING TO READ FROM AN AMIGA DEVICE
  3850. $0004000c    Some problem has occurred when trying to read a file from an
  3851. $0004000d    Amiga drive.  Check the spelling of the filename and the DRIVES
  3852.         settings (See DRIVES and AMIGA DRIVES in the SYSTEM MENU
  3853.         section).
  3854.  
  3855. $80050000    COULD NOT OPEN: MSGPORT
  3856.         Should NEVER happen.
  3857.  
  3858. $80050001    COULD NOT OPEN: REPLY PORT
  3859.         Should NEVER happen.
  3860.  
  3861. $80050002    COULD NOT OPEN: INPUT DEVICE
  3862.         Should NEVER happen.
  3863.  
  3864. $80050003    COULD NOT: ADD IEHANDLER
  3865.         Should NEVER happen.
  3866.  
  3867. $80050004    COULD NOT: DOIO.
  3868.         Should NEVER happen.
  3869.  
  3870. $80060000    COULD NOT TAKE: CIA A: SERIAL DATA INTERRUPT
  3871.         You are running another program that is utilizing a low level
  3872.         function of your Amiga.  The other program must be exited
  3873.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  3874.            section).
  3875.  
  3876. $80060001    COULD NOT FREE: CIA A: SERIAL DATA INTERRUPT
  3877.         Should NEVER happen.
  3878.  
  3879. $80070000    COULD NOT TAKE: CIA B: TIMER B INTERRUPT
  3880.         You are running another program that is utilizing a low level
  3881.         function of your Amiga.  The other program must be exited
  3882.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  3883.            section).
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.                                                                         6-6
  3891.  
  3892.  
  3893.  
  3894. -
  3895.  
  3896.  
  3897.  
  3898. $80080000    COULD NOT TAKE: CIA B: TOD INTERRUPT
  3899.         You are running another program that is utilizing a low level
  3900.         function of your Amiga.  The other program must be exited
  3901.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  3902.            section).
  3903.  
  3904. $80080001    COULD NOT FREE: CIA B: TOD INTERRUPT
  3905.         Should NEVER happen.
  3906.  
  3907. $00080002    PROGRAM HAS OVER 25 RASTER IRQs
  3908.         A64 will support up to 25 raster IRQs per screen, this is the
  3909.         equivalent of 1500 interrupts per second and we've not yet come
  3910.         across a C64 program that utilizes anywhere near this many.  If
  3911.         you get this error we would like to hear about it.
  3912.  
  3913. $00080003    PROGRAM DOING UNIMPLEMENTED RASTER IRQ AT SCAN LINE 0
  3914.         A64 will handle raster IRQs at every scan line except 0.  This
  3915.         is because of a problem with the raster IRQ handler and will be
  3916.         fixed in a future version.
  3917.  
  3918. $00090000    COULD NOT TAKE: SERIAL PORT
  3919.         Some program has exclusive use of the Amiga's serial port.
  3920.         You must make the program release the serial port before A64
  3921.         can use it (See SER PORT in the SYSTEM MENU section).
  3922.  
  3923. $00090001    RS-232 ERROR: RECEIVE BUFFER OVERRUN
  3924.         A64 is not keeping up with the data coming in over the serial
  3925.         port. This has not been a problem so we have never seen this
  3926.         error.
  3927.  
  3928. $00090002    RS-232 ERROR: RECEIVE BUFFER FULL
  3929.         A64 is not keeping up with the data coming in over the serial
  3930.         port. This has not been a problem so we have never seen this
  3931.         error.
  3932.  
  3933. $000c0000    ILLEGAL VIC MODE:
  3934.         Should NEVER happen.
  3935.  
  3936. $000d0x01    BLITTER VSIZE ERROR: VSIZE = 0
  3937. $000d0x03    Should NEVER happen.  The "x" in the error number will be the
  3938. $000d0x05    number 1-6.
  3939.  
  3940. $000d0x02    BLITTER VSIZE ERROR: VSIZE > 8
  3941. $000d0x04    Should NEVER happen.  The "x" in the error number will be the
  3942. $000d0x06    number 1-6.
  3943.  
  3944. $000e0000    COULD NOT OPEN OR WRITE: IFF OUTPUT FILE
  3945. $000e0001    For some reason A64 could not create the IFF file you've
  3946.         requested.  Make sure you've entered the filename correctly
  3947.         (See SAVE SCREEN in the TOOLS MENU section).
  3948.  
  3949. $000e0002    OUT OF MEMORY, COULD NOT ALLOCATE: IFF FILE BUFFER
  3950.         A64 does not have enough memory to perform the operation (See
  3951.         A64 AND MEMORY in the TECHNICAL section).
  3952.  
  3953.  
  3954.  
  3955.  
  3956.                                                                         6-7
  3957.  
  3958.  
  3959.  
  3960. -
  3961.  
  3962.  
  3963.  
  3964. $000f0000    A64 HARDWARE INTERFACE IS NOT INSTALLED
  3965.         A64's hardware interface is not connected to the Amiga.  You
  3966.         must connect it (See INSTALLING A64's HARDWARE INTERFACE in the
  3967.         GETTING STARTED section).
  3968.  
  3969. $00100000    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM
  3970.         A64 does not have enough memory to perform the operation (See
  3971.         A64 AND MEMORY in the TECHNICAL section).
  3972.  
  3973. $00100001    COULD NOT OPEN: COLOR SCREEN
  3974.         If this error occurs you are probably out of memory (See A64
  3975.         AND MEMORY in the TECHNICAL section).
  3976.  
  3977. $00100002    COULD NOT OPEN: COLOR WINDOW
  3978.         If this error occurs you are probably out of memory (See A64
  3979.         AND MEMORY in the TECHNICAL section).
  3980.  
  3981. $xxxxxxxx    PROGRAM TRYING TO EXECUTE BETWEEN OPCODES AT PC: $xxxxxxxx
  3982.         The program is executing between opcodes.  This error can be
  3983.         corrected by installing the C64 ROMs (See ROMs in the TECHNICAL
  3984.         section).
  3985.  
  3986. $xxxxxxxx    UNKNOWN OPCODE: $xx AT PC: $xxxxxxxx
  3987.         A64 has encountered an unknown opcode.  This could be caused
  3988.         either a C64 crash or A64 trying to execute certain
  3989.         unimplemented "undefined opcodes."  Many of the 6502's
  3990.         undefined opcodes have been supported, but we lack good
  3991.         documentation on them, so when in doubt we left it out. If
  3992.         anyone out there has any documentation on the 6502's undefined
  3993.         opcodes we would greatly appreciate getting a copy so we could
  3994.         fully implement the 6502's undefined opcodes.
  3995.  
  3996. $xxxxxxxx    PC ERROR
  3997.         A64 is trying to execute at an illegal C64 address. The only
  3998.         way we know of this error occurring is if a C64 program tries to
  3999.         execute in the CHAR ROM area, a very unlikely occurrence, but
  4000.         we have learned that if something is possible on a C64, someone
  4001.         has done it. If you encounter this error we would like to hear
  4002.         about it.
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.                                                                         6-8
  4023.  
  4024.  
  4025.  
  4026. -
  4027.  
  4028.  
  4029.  
  4030. INCOMPATIBILITIES
  4031.  
  4032.     Alot of time has been spent trying to make A64 as compatible as possible.
  4033.     Unfortunately the only way to get 100% compatibility with a C64 is to use a
  4034.     C64.  Listed below are the things that A64 does not currently handle:
  4035.  
  4036. FAST LOADERS
  4037.  
  4038.     The biggest problem with compatibility is related to disk I/O.  We all know
  4039.     how slow the 1541 disk drive is and alot of software manufactures try to
  4040.     correct this problem by writing custom disk drive routines, called FAST
  4041.     LOADERS, to load and save programs faster than the normal rate.  These
  4042.     routines are VERY time critical and must be run at 100% speed, with no
  4043.     interruptions, to function properly.  Also these routines vary from program
  4044.     to program.  A FAST LOADER that works with one program will not work with 
  4045.     another.  The only way to emulate these routines is to write a custom
  4046.     loader for each program that utilizes a FAST LOADER.  Seeing how there are
  4047.     literally hundreds of FAST LOADER programs out there it would be nearly
  4048.     impossible to emulate all of them.
  4049.  
  4050.     There is no way to tell if a program uses a FAST LOADER until you try to
  4051.     load it.  The must likely result of trying to load a program that uses one
  4052.     is the C64 program will stop and disk drive motor and or light will stay
  4053.     on.  If this happen you must reset both A64 and the disk drive to abort
  4054.     the operation (See RESET A64 in the PROJECT MENU section).
  4055.  
  4056.     Future revisions of A64 may emulate some FAST LOADERS. If you have a
  4057.     program that uses a FAST LOADER and you would like to see A64 run it, put
  4058.     the name of it on the registration form or write us a letter.  We will
  4059.     spend the time working on the must requested programs.
  4060.  
  4061. CASSETTE PORT, USER PORT and CARTRIDGE PORT
  4062.  
  4063.     Seeing how the cassette, user and cartridge ports are not present on the
  4064.     Amiga they are not supported by A64.  There is an exception to this in that
  4065.     Amiga modems are supported where C64 modems are normally connected to the
  4066.     C64 user port (See MODEMS in the SYSTEM MENU section).  Also cartridge
  4067.     programs that have been converted to run from disk should work.
  4068.  
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.                                                                         6-9
  4089.  
  4090.  
  4091.  
  4092. -
  4093.  
  4094.  
  4095.  
  4096. KNOWN BUG
  4097.  
  4098.     Although we have painstakingly tried to make A64 bug free, a bug turned up
  4099.     during testing and was not corrected in time for this release.  This bug is
  4100.     easily avoided and we do plan on trying to correct it in a future release.
  4101.     We hope no other bugs have escaped our attention, but if you do come across
  4102.     one, please let us know so that we can try to correct it.
  4103.  
  4104.     The bug involves the PAR PORT menu option in the SYSTEM menu.  When this
  4105.     option is set to A64 and you try to access the parallel port from another
  4106.     program a GURU MEDITATION error will occur.  This bug seems to be in the
  4107.     Amiga's parallel device handler.  It appears that the parallel device
  4108.     handler is not doing the correct error handling when the parallel port is
  4109.     not available for use.  The way to avoid this bug is whenever you want to
  4110.     access the parallel port from another program besides A64 make sure the PAR
  4111.     PORT menu option is set to AMIGA.
  4112.  
  4113.     NOTE: This bug is not present for the serial port.
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.                                                                         6-10
  4155.  
  4156.  
  4157.  
  4158. -
  4159.  
  4160.  
  4161.  
  4162. WHAT IS IN THE FUTURE
  4163.  
  4164.     We can just about guarantee at least one revision of The A64 Package, there
  4165.     has been just too much work already done, on other features, not to update
  4166.     it.  As far as, when The A64 Package will be updated and how many new
  4167.     features are added, depends on how many people support The A64 Package, by
  4168.     sending in the license fee.  The more response we get, the more willing
  4169.     we'll be to spend the time adding new features and to get new versions of
  4170.     The A64 Package out there.
  4171.  
  4172.     The features that have been worked on (or at least given some serious
  4173.     consideration), that didn't make it into this release of The A64 Package,
  4174.     are almost too numerous to mention.  We have put together a list of some of
  4175.     the more important features that we would like to add to future versions.
  4176.     If you have any suggestions or comments about new features, we would like
  4177.     to hear about them, put them on the registration form when sending in the
  4178.     license fee.
  4179.  
  4180.         SOUND: We realize that many of you think sound support is VERY
  4181.         important and so do we.  We have a very talented programmer working
  4182.         solely on sound support and he has made excellent progress with this
  4183.         complex programming task.  He will complete the sound support in the
  4184.         very near future and it will be included with the next release.
  4185.  
  4186.         A64MON: A64Mon is an Amiga based, C64 system monitor. A64Mon is a
  4187.         powerful C64 debugging and hacking tool, it give you the ability to
  4188.         stop any C64 program, that A64 is running, and examine its internals.
  4189.         A64Mon is an Amiga program, so it runs totally transparent to the C64
  4190.         program that A64 is running, there is no stopping it from working.
  4191.         A64Mon has numerous features and commands that make "monitoring" a C64
  4192.         program a snap.  Some of its features include: PetASCII dump,
  4193.         disassembler, chip dumps, hex dump, edit memory, saving from and loading
  4194.         to the C64's memory map, all command output can be sent to Amiga disks
  4195.         or printers and it's all done in the Amiga environment.  A64Mon was
  4196.         used quite extensively during the development of A64 and we found it
  4197.         an invaluable tool for finding out "what is the C64 program doing." 
  4198.         A64Mon is about 80% completed and it will be be included with the next
  4199.         release.
  4200.  
  4201.         AMIGA PRINTERS: A64 will have the ability to use Amiga printers in the
  4202.         same way it's able to use Amiga drives.
  4203.  
  4204.         AMIGA DRIVES: While the Amiga drive support is fully functional, it can
  4205.         be improved. Some of the drawbacks of Amiga drives are outlined in the
  4206.         AMIGA DRIVES section.
  4207.  
  4208.         C64 DEVICES: This one is a big one.  The A64 Package comes with some
  4209.         utility programs that allow you to transfer C64 programs to and from
  4210.         Amiga disks.  The key to these utilities is the ability to access C64
  4211.         devices directly from AmigaDOS.  By using this ability several other
  4212.         programs can be developed, like: a full featured, Amiga based, file
  4213.         transfer program and device drivers to use C64 disk drives and printers
  4214.         as Amiga devices so they can be used with ANY Amiga program.  Quite a
  4215.         bit of work has already been done in this area, but to fully develop
  4216.         these features, The A64 Package needs alot of support.
  4217.  
  4218.  
  4219.  
  4220.                                                                         7-1
  4221.  
  4222.  
  4223.  
  4224. -
  4225.  
  4226.  
  4227.  
  4228.         MODEMS: Amiga modem support is still in development and should be
  4229.         completed by the next release.
  4230.  
  4231.         INPUT DEVICES: A64 will support more C64 input devices, like paddles
  4232.         and C64 mice.  We have also considered using the Amiga's mouse to
  4233.         emulate certain C64 input devices.
  4234.  
  4235.         FAST LOADERS: We would like to support some FAST LOADERS in the future.
  4236.         A couple that we've considered are: GEOS and ISEPIC.  Let us know if
  4237.         you have others in mind.
  4238.  
  4239.         FILE REQUESTERS: Full featured file requesters in A64 Prefs.
  4240.  
  4241.         A64 PREFS SETTINGS: A64 Prefs will have many more settings that allow
  4242.         you to fine tune A64 to run a C64 program.  A64 was designed to be able
  4243.         to do many things at variable rates; like redraw the screen, handle C64
  4244.         interrupts and other things that effect the speed of A64.  In the
  4245.         future A64 Prefs will give you the ability to change these rates to
  4246.         make A64 run faster.
  4247.  
  4248.         COLOR SCREEN: The A64 COLORS' screen is still in development and when
  4249.         it's  completed it will have many new features, like: UNDO, COPY, SWAP,
  4250.         SPREAD, etc.  It should be noted that the COLORS' screen is fully
  4251.         functional as is and should not contain any bugs.
  4252.  
  4253.         SPRITES: A64 fully supports the C64's sprites, but work can be done in
  4254.         a number of areas concerning them, especially their flickering.
  4255.  
  4256.         FONTS: A64 will have the ability to change, load and save C64 fonts and
  4257.         maybe the ability to convert C64 fonts to Amiga fonts.
  4258.  
  4259.         And the list could go on and on...
  4260.  
  4261.     NOTE:  Even if this list already contains the features that YOU would like
  4262.            to see added to The A64 Package, you should still let us know what
  4263.            they are, to help us decide what features are more important to add
  4264.            first. 
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.                                                                         7-2
  4287.  
  4288.  
  4289.  
  4290. -
  4291.  
  4292.  
  4293.  
  4294. ERROR REPORT
  4295.  
  4296.     We have supplied an ERROR REPORT that you can send to us if you are
  4297.     experiencing difficulties with running a certain C64 program on A64.  This
  4298.     error report will help us to track down problems more easily and to get
  4299.     better revisions of A64 out quickly.  We realize that the majority of the
  4300.     people using A64 will not use these error reports, but if some of you do it
  4301.     will make our job a little easier.  If it is possible, you may also send us
  4302.     a copy of the program that caused the problems.  We realize that it is not
  4303.     practical to expect anyone to do this, but if some of you do it could save
  4304.     us a great deal of time by eliminating the need to track down the program.
  4305.     Please note that QuesTronix does not endorse copyright infringement and you
  4306.     should note a programs copyright status before sending it to us.
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.  
  4320.  
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.  
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.                                                                           A
  4353.  
  4354.  
  4355.  
  4356. -
  4357.  
  4358. A64 ERROR REPORT                  A64 VERSION ___________________
  4359.                               (from title screen)
  4360.  
  4361. C64 PROGRAM NAME _______________________________________ VERSION ____________
  4362.  
  4363. MANUFACTURER ________________________________________________________________
  4364.  
  4365. TYPE OF PROGRAM:   GAME ___ GRAPHICS ___ UTILITIES ___ SOUND ___ BUSINESS ___ 
  4366.  
  4367.                    EDUCATION ___ OTHER (Specify) ____________________________
  4368.  
  4369. WHAT AMIGA MODEL ARE YOU USING ______________________________________________
  4370.  
  4371. HOW IS YOUR AMIGA CONFIGURED (Ex. RAM, Special boards, hard disk) ___________
  4372.  
  4373. _____________________________________________________________________________
  4374.  
  4375.  
  4376. FILL IN THE FOLLOWING INFORMATION IF APPLICABLE (It is obtained by selecting
  4377.    DEBUG when an error requester occurs).
  4378.  
  4379. INTERNAL ERROR #: $____________
  4380.  
  4381. D0: $____________   D1: $____________   D2: $____________   D3: $____________
  4382.  
  4383. D4: $____________   D5: $____________   D6: $____________   D7: $____________
  4384.  
  4385. A0: $____________   A1: $____________   A2: $____________   A3: $____________
  4386.  
  4387. A4: $____________   A5: $____________   A6: $____________   A7: $____________
  4388.  
  4389. PC: $____________   SR: $____________
  4390.  
  4391.  
  4392. PLEASE GIVE A DISCRIPTION OF THE PROBLEM (Be as specific as possible) _______
  4393.  
  4394. _____________________________________________________________________________
  4395.  
  4396. _____________________________________________________________________________
  4397.  
  4398. _____________________________________________________________________________
  4399.  
  4400. _____________________________________________________________________________
  4401.  
  4402. _____________________________________________________________________________
  4403.  
  4404. _____________________________________________________________________________
  4405.  
  4406. _____________________________________________________________________________
  4407.  
  4408. _____________________________________________________________________________
  4409.  
  4410. _____________________________________________________________________________
  4411.  
  4412. _____________________________________________________________________________
  4413.  
  4414. _____________________________________________________________________________
  4415.  
  4416. _____________________________________________________________________________
  4417.  
  4418. _____________________________________________________________________________
  4419.  
  4420.      (Please use a separate ERROR REPORT for each C64 program).
  4421.  
  4422. -
  4423.